BSO Resolver

Trình phân giải BSO dịch tên miền .bso thành khóa công khai tương ứng bằng cách đọc các bản ghi TXT Bitsocial được lưu trữ trên ENS. Nó cung cấp một ứng dụng khách viem dùng chung, bộ nhớ đệm liên tục và hoạt động trong cả môi trường Node.js và trình duyệt.

• GitHub: bitsocialnet/bso-resolver
• Giấy phép: Chỉ GPL-2.0

Cài đặt

npm install @bitsocial/bso-resolver

Tạo một bộ giải quyết

Khởi tạo trình phân giải bằng cách chuyển một đối tượng cấu hình tới hàm tạo:

const resolver = new BsoResolver({ key, provider, dataPath });

Tham số	Bắt buộc	Mô tả
key	Có	Mã định danh cho phiên bản trình phân giải.
provider	Có	Cấu hình vận chuyển (xem bên dưới).
dataPath	Không	Thư mục dành cho tệp bộ nhớ đệm SQLite (chỉ dành cho Node.js).

Tùy chọn nhà cung cấp

Tham số provider chấp nhận ba định dạng:

• "viem" -- Sử dụng phương tiện giao thông công cộng mặc định do viem cung cấp.
• URL HTTP(S) -- Kết nối thông qua điểm cuối JSON-RPC (ví dụ: https://mainnet.infura.io/v3/YOUR_KEY).
• URL WebSocket -- Kết nối thông qua điểm cuối WebSocket RPC (ví dụ: wss://mainnet.infura.io/ws/v3/YOUR_KEY).

phương pháp

resolve({ name, abortSignal? })

Tra cứu tên .bso và trả về khóa chung được liên kết. AbortSignal tùy chọn có thể được chuyển để hủy các yêu cầu dài hạn.

canResolve({ name })

Trả về một boolean cho biết liệu trình phân giải có thể xử lý tên đã cho hay không. Sử dụng tính năng này để kiểm tra hỗ trợ trước khi thử độ phân giải đầy đủ.

destroy()

Phá bỏ trình phân giải, đóng các kết nối cơ sở dữ liệu và giải phóng tài nguyên. Gọi điều này khi trình phân giải không còn cần thiết nữa.

Bộ nhớ đệm

Tên đã giải quyết được lưu trữ tự động để giảm việc tra cứu mạng dư thừa. Phần phụ trợ bộ nhớ đệm được chọn dựa trên môi trường thời gian chạy:

Môi trường	Phần cuối	Ghi chú
Node.js	SQLite	Được lưu trữ tại dataPath. Sử dụng chế độ WAL để truy cập đồng thời.
Trình duyệt	IndexedDB	Sử dụng các giao dịch IndexedDB gốc.
Dự phòng	Map trong bộ nhớ	Được sử dụng khi cả SQLite lẫn IndexedDB đều không có sẵn.

Tất cả các mục trong bộ nhớ đệm đều có TTL một giờ và sẽ tự động bị xóa sau khi hết hạn.

Tích hợp với pkc-js

Trình phân giải có thể được cắm trực tiếp vào pkc-js thông qua tùy chọn nameResolvers, cho phép phân giải tên .bso trong suốt trong quá trình tra cứu khóa:

const pkc = new Pkc({
  nameResolvers: [resolver],
  // ...other options
});

Đồng thời

Trình phân giải được thiết kế để an toàn khi sử dụng đồng thời:

• Một máy khách viem được chia sẻ duy nhất sẽ tránh được các kết nối dư thừa.
• SQLite hoạt động ở chế độ WAL (Ghi nhật ký ghi trước), cho phép đọc đồng thời mà không bị chặn.
• Bộ nhớ đệm của trình duyệt dựa vào các giao dịch IndexedDB gốc để tách biệt.

Điểm vào nền tảng

Gói này cung cấp các điểm vào riêng biệt cho các bản dựng trình duyệt và Node.js. Các gói hỗ trợ trường exports trong package.json sẽ tự động chọn đúng gói.