用途:访问铭刻在 BSV 交易中的媒体,包括链上图片、视频、文件,以及读取 ORDFS 内容与元数据。SDK 未导出专门的提取 action,可通过三种方式访问。
主要能力与用法: 一、SDK 服务层 ctx.services.ordfs(OrdfsClient):getMetadata(outpoint, -2) 获取元数据(contentType、origin、MAP 字段,传 -2 解析至 origin);getContent(origin) 返回原始字节 Uint8Array 与响应头;getContentUrl(outpoint) 仅返回 URL,便于 img/video 标签使用;bulkMetadata([op1, op2]) 批量获取多个 outpoint 的元数据。 二、ORDFS HTTP 网关(无需 SDK):直接 fetch 网关端点。内容按 outpoint(txid_vout)访问 https://api.1sat.app/content/<outpoint>;1sat-stack 内容代理为 https://api.1sat.app/1sat/content/<outpoint>;流式内容为 https://api.1sat.app/1sat/ordfs/stream/<outpoint>;仅元数据为 https://api.1sat.app/1sat/ordfs/metadata/<outpoint>;公共网关 https://ordfs.network/<outpoint>。网关返回正确的 Content-Type,URL 可直接用于 img、video、audio 标签。 三、txex CLI(外部第三方工具,非本 SDK 一部分):安装命令 bun add -g txex;提取交易全部媒体 txex <txid>;指定输出目录 txex <txid> -o /path/to/output。可写出 PNG/JPG/GIF/WEBP 图片、MP4/WEBM 视频、MP3/WAV/OGG 音频、文本/JSON/Markdown 及任意二进制数据,自动识别扩展名。另有便利封装脚本 bun run scripts/extract.ts <txid> [output-dir],仅调用 txex,不属于 SDK 运行时,也不导出 action。
适用场景:查看 NFT 图片、在代码中读取内容、检查类型/来源/MAP、用 txex 批量导出归档、校验链上实际铭刻内容。
限制:SDK 不提供导出的“extract” action;txex 为第三方外部工具;其余收费、价格、平台等信息暂未提供。