MCP 工具参考

本参考列出可用的 MCP 工具、权限和输入参数。具体操作以客户端当前获取的工具列表和结果为准。

如何阅读本参考

权限是主要必需的权限范围。修改操作可能因已确认的次要影响而需要额外权限，例如删除网站最后一个关联或清理其 Storage 引用。

每个工具列出顶层输入。打开 JSON 结构可查看嵌套结构、枚举和确切约束。除通用工具结构外，模板内容还由后端模板解析器验证。

这些流程请参见交易确认和资源限制。

访问与钱包

`auth.policy`

返回公开的 MCP 认证流程、权限范围、安全控制、保留规则和确认规则。

权限: public本地读取

无输入参数。

JSON 输入结构

json

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`auth.status`

返回当前 MCP 会话是否已认证。

权限: public本地读取

无输入参数。

JSON 输入结构

json

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`mcp.access.list`

列出已认证所有者钱包的 MCP 授权和脱敏的活跃会话。

权限: mcp:read远程读取

无输入参数。

JSON 输入结构

json

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`mcp.access.revoke_consent`

按 id 撤销一项 MCP 授权，并使匹配的访问/刷新令牌失效。

权限: mcp:revoke破坏性操作

输入	类型	必填
`consentId`	`string`	是
`confirmConsentId`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "consentId": {
      "type": "string",
      "minLength": 1
    },
    "confirmConsentId": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "consentId",
    "confirmConsentId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`mcp.audit.list`

列出已认证所有者钱包近期的脱敏 MCP 审计事件。

权限: mcp:read远程读取

输入	类型	必填
`limit`	`integer`	否
`method`	`string`	否
`resultStatus`	`"success" \| "error"`	否
`since`	`string`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "method": {
      "type": "string",
      "minLength": 1
    },
    "resultStatus": {
      "type": "string",
      "enum": [
        "success",
        "error"
      ]
    },
    "since": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`mcp.audit.summary`

返回限定于所有者范围的 MCP 审计汇总指标，不包含原始请求头或请求体。

权限: mcp:read远程读取

输入	类型	必填
`windowHours`	`integer`	否
`topMethodsLimit`	`integer`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "windowHours": {
      "type": "integer",
      "minimum": 1,
      "maximum": 720
    },
    "topMethodsLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`wallet.me`

返回已认证 MCP 所有者/执行者的钱包上下文。

权限: wallet:read远程读取

无输入参数。

JSON 输入结构

json

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

网站与部署

`deployments.list`

列出所有者各网站中保留的部署。

权限: deployments:read远程读取

无输入参数。

JSON 输入结构

json

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`media.upload_image`

将一张 PNG、JPEG、GIF 或 WebP 图片上传到已认证所有者的模板媒体存储。

权限: media:write写入

输入	类型	必填
`contentBase64`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "contentBase64": {
      "type": "string",
      "minLength": 4,
      "maxLength": 11184812
    }
  },
  "required": [
    "contentBase64"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.attach_domain`

预检后关联一个已通过 DNS 链接的域名。准确确认网站和完整域名。移动域名时传入已检查的 expectedConflictSiteId；删除来源网站还需要 confirmDeleteSourceSiteId 和 sites:delete。所有受影响网站必须归当前所有者所有且已获委托。不签名或更改 DNS 记录。

权限: sites:write破坏性操作

输入	类型	必填
`site`	`string`	是
`domain`	`string`	是
`confirmSite`	`string`	是
`confirmDomain`	`string`	是
`expectedConflictSiteId`	`integer \| null`	否
`confirmDeleteSourceSiteId`	`integer`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    },
    "domain": {
      "type": "string",
      "minLength": 1
    },
    "confirmSite": {
      "type": "string",
      "minLength": 1
    },
    "confirmDomain": {
      "type": "string",
      "minLength": 1
    },
    "expectedConflictSiteId": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "confirmDeleteSourceSiteId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "site",
    "domain",
    "confirmSite",
    "confirmDomain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.delete`

删除拥有的 TON Site 部署及其提供的文件。

权限: sites:delete破坏性操作

输入	类型	必填
`site`	`string`	是
`confirmSite`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    },
    "confirmSite": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "site",
    "confirmSite"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.get_content`

读取拥有的网站已存储的模板/内容元数据。

权限: sites:read远程读取

输入	类型	必填
`site`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "site"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.list`

列出已授权钱包拥有的 TON Sites。

权限: sites:read远程读取

无输入参数。

JSON 输入结构

json

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.list_domains`

列出拥有的网站的域名和当前 DNS 状态。接受网站名称或稳定的网站 ID，并执行网站/域名委托限制。

权限: sites:read远程读取

输入	类型	必填
`site`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "site"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.list_releases`

列出拥有的网站保留的发布版本。

权限: sites:read远程读取

输入	类型	必填
`site`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "site"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.preflight_domain`

将 .ton、.t.me 或受支持的子域关联到拥有的网站前，读取当前所有权、DNS 关联和冲突。不更改映射或 DNS 记录。

权限: sites:read远程读取

输入	类型	必填
`site`	`string`	是
`domain`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    },
    "domain": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "site",
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.publish_files`

根据明确的文件内容，部署或更新拥有的 TON Site。

权限: sites:write破坏性操作

输入	类型	必填
`site`	`string`	是
`files`	`object[]`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "minLength": 1
          },
          "text": {
            "type": "string"
          },
          "contentBase64": {
            "type": "string"
          }
        },
        "required": [
          "path"
        ],
        "additionalProperties": false
      },
      "minItems": 1
    }
  },
  "required": [
    "site",
    "files"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.publish_template`

验证、渲染并发布基于模板的 TON Site。

权限: sites:write破坏性操作

输入	类型	必填
`site`	`string`	是
`template`	`string`	是
`content`	`JSON 值`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    },
    "template": {
      "type": "string",
      "minLength": 1
    },
    "content": {}
  },
  "required": [
    "site",
    "template"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.rollback`

将拥有的 TON Site 回滚到保留的发布版本。

权限: sites:rollback破坏性操作

输入	类型	必填
`site`	`string`	是
`releaseId`	`string`	是
`confirmSite`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    },
    "releaseId": {
      "type": "string",
      "minLength": 1
    },
    "confirmSite": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "site",
    "releaseId",
    "confirmSite"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.send_link_tx`

验证索引中的所有权，并返回一个 HTTPS 页面，供用户通过 TON Connect 检查和确认确切的 TON DNS 网站交易。

权限: transactions:request写入

输入	类型	必填
`site`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "site"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`sites.unlink_domain`

当域名的 DNS 网站记录不再指向此网站（或其所有者已改变）后，取消关联。准确确认网站和完整域名。移除最后一个域名会删除网站，需要 confirmDeleteSite 和 sites:delete；清理 Storage 托管网站还需要 storage:delete 和 Bag 委托。不签名或更改 DNS 记录。

权限: sites:write破坏性操作

输入	类型	必填
`site`	`string`	是
`domain`	`string`	是
`confirmSite`	`string`	是
`confirmDomain`	`string`	是
`confirmDeleteSite`	`boolean`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1
    },
    "domain": {
      "type": "string",
      "minLength": 1
    },
    "confirmSite": {
      "type": "string",
      "minLength": 1
    },
    "confirmDomain": {
      "type": "string",
      "minLength": 1
    },
    "confirmDeleteSite": {
      "type": "boolean"
    }
  },
  "required": [
    "site",
    "domain",
    "confirmSite",
    "confirmDomain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

DNS 与用户名

`dns.lookup`

查询 .ton 名称的公开 TON DNS 状态和记录。

权限: dns:read远程读取

输入	类型	必填
`name`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`dns.send_name_tx`

为已验证的 .ton 铸造、拍卖出价或过期名称释放交易返回一个 HTTPS 页面。

权限: transactions:request写入

输入	类型	必填
`domain`	`string`	是
`action`	`"mint" \| "bid" \| "release"`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "minLength": 1
    },
    "action": {
      "type": "string",
      "enum": [
        "mint",
        "bid",
        "release"
      ]
    }
  },
  "required": [
    "domain",
    "action"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`dns.send_record_tx`

重新验证索引中的所有权，并返回一个 HTTPS 页面，供用户检查和确认确切的 TON DNS 记录交易。

权限: transactions:request写入

输入	类型	必填
`domain`	`string`	是
`kind`	`"wallet" \| "site" \| "storage" \| "resolver" \| "text" \| "adnl" \| "other"`	是
`valueKind`	`"wallet" \| "site" \| "storage" \| "resolver" \| "text" \| "adnl" \| "other"`	否
`value`	`string \| null`	否
`rawCategory`	`string`	否
`keyName`	`string`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "minLength": 1
    },
    "kind": {
      "type": "string",
      "enum": [
        "wallet",
        "site",
        "storage",
        "resolver",
        "text",
        "adnl",
        "other"
      ]
    },
    "valueKind": {
      "type": "string",
      "enum": [
        "wallet",
        "site",
        "storage",
        "resolver",
        "text",
        "adnl",
        "other"
      ]
    },
    "value": {
      "type": [
        "string",
        "null"
      ]
    },
    "rawCategory": {
      "type": "string"
    },
    "keyName": {
      "type": "string"
    }
  },
  "required": [
    "domain",
    "kind"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`dns.send_renew_tx`

重新验证一至四个拥有的 .ton 名称，并返回一个 HTTPS 页面，用于一次 TON Connect 多消息确认。

权限: transactions:request写入

输入	类型	必填
`domains`	`string[]`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "domains": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 1,
      "maxItems": 4
    }
  },
  "required": [
    "domains"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`dns.send_transfer_tx`

重新验证根 .ton 名称或 .t.me 用户名的所有权，并返回一个 HTTPS 页面，以确认将其 NFT 转移至 newOwner。用户在钱包中签名。

权限: transactions:request破坏性操作

输入	类型	必填
`domain`	`string`	是
`newOwner`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "minLength": 1
    },
    "newOwner": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "domain",
    "newOwner"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`domains.list`

列出已授权钱包拥有的 .ton 域名。

权限: dns:read远程读取

无输入参数。

JSON 输入结构

json

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`domains.list_usernames`

列出已授权钱包拥有的 .t.me Telegram 用户名，并按其域名委托范围筛选。

权限: dns:read远程读取

无输入参数。

JSON 输入结构

json

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`domains.records`

读取拥有的 .ton 域名或 .t.me Telegram 用户名的 DNS 记录。

权限: dns:read远程读取

输入	类型	必填
`domain`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

子域

`subdomains.collection_action_tx`

重新验证当前集合或父名称权限，并返回一个 HTTPS 管理交易确认页面。

权限: transactions:request破坏性操作

输入	类型	必填
`collectionAddress`	`string`	是
`action`	`"withdraw_fees" \| "set_access" \| "set_allowlist" \| "set_label_reserved" \| "transfer_admin" \| "link_resolver" \| "unlink_resolver" \| "enforce_resolver" \| "fill_parent" \| "claim" \| "claim_revenue" \| "convert_locked" \| "retry_parent_return"`	是
`accessMode`	`"public" \| "allowlist" \| "admin_only"`	否
`wallet`	`string`	否
`allowed`	`boolean`	否
`label`	`string`	否
`reserved`	`boolean`	否
`newAdmin`	`string`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "collectionAddress": {
      "type": "string",
      "minLength": 1
    },
    "action": {
      "type": "string",
      "enum": [
        "withdraw_fees",
        "set_access",
        "set_allowlist",
        "set_label_reserved",
        "transfer_admin",
        "link_resolver",
        "unlink_resolver",
        "enforce_resolver",
        "fill_parent",
        "claim",
        "claim_revenue",
        "convert_locked",
        "retry_parent_return"
      ]
    },
    "accessMode": {
      "type": "string",
      "enum": [
        "public",
        "allowlist",
        "admin_only"
      ]
    },
    "wallet": {
      "type": "string"
    },
    "allowed": {
      "type": "boolean"
    },
    "label": {
      "type": "string"
    },
    "reserved": {
      "type": "boolean"
    },
    "newAdmin": {
      "type": "string"
    }
  },
  "required": [
    "collectionAddress",
    "action"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`subdomains.control`

为已认证钱包读取最新集合授权和父名称归还状态。

权限: subdomains:read远程读取

输入	类型	必填
`collectionAddress`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "collectionAddress": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "collectionAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`subdomains.create_collection_tx`

重新验证父名称所有权，创建集合元数据，并返回一个 HTTPS 交易确认页面。

权限: transactions:request写入

输入	类型	必填
`parentAddress`	`string`	是
`mode`	`"locked" \| "linked"`	是
`priceGrid`	`string[]`	是
`minChars`	`integer`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "parentAddress": {
      "type": "string",
      "minLength": 1
    },
    "mode": {
      "type": "string",
      "enum": [
        "locked",
        "linked"
      ]
    },
    "priceGrid": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d+$"
      },
      "minItems": 11,
      "maxItems": 11
    },
    "minChars": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4
    }
  },
  "required": [
    "parentAddress",
    "mode",
    "priceGrid",
    "minChars"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`subdomains.get_collection`

当已认证钱包持有集合或父名称权限时，读取最新集合快照。

权限: subdomains:read远程读取

输入	类型	必填
`collectionAddress`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "collectionAddress": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "collectionAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`subdomains.get_item`

读取已认证钱包拥有的子域 NFT 条目。

权限: subdomains:read远程读取

输入	类型	必填
`itemAddress`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "itemAddress": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "itemAddress"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`subdomains.list_collections`

列出已认证钱包控制的 TON 子域集合。

权限: subdomains:read远程读取

输入	类型	必填
`limit`	`integer`	否
`cursor`	`string`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`subdomains.list_items`

列出已认证钱包拥有的 TON 子域 NFT 条目。

权限: subdomains:read远程读取

输入	类型	必填
`limit`	`integer`	否
`cursor`	`string`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "type": "string",
      "minLength": 1
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`subdomains.mint_tx`

重新验证可用性和访问权限，构建元数据，并返回一个 HTTPS 铸造或待处理铸造确认页面。

权限: transactions:request写入

输入	类型	必填
`collectionAddress`	`string`	是
`parent`	`string`	是
`label`	`string`	是
`setWalletToMinter`	`boolean`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "collectionAddress": {
      "type": "string",
      "minLength": 1
    },
    "parent": {
      "type": "string",
      "minLength": 1
    },
    "label": {
      "type": "string",
      "minLength": 1
    },
    "setWalletToMinter": {
      "type": "boolean"
    }
  },
  "required": [
    "collectionAddress",
    "parent",
    "label"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`subdomains.recovery_tx`

重新推导拥有的集合，并为其部署或解析器恢复交易返回一个 HTTPS 页面。

权限: transactions:request写入

输入	类型	必填
`parentAddress`	`string`	是
`mode`	`"locked" \| "linked"`	是
`action`	`"retry_deployment" \| "link_resolver" \| "enforce_resolver"`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "parentAddress": {
      "type": "string",
      "minLength": 1
    },
    "mode": {
      "type": "string",
      "enum": [
        "locked",
        "linked"
      ]
    },
    "action": {
      "type": "string",
      "enum": [
        "retry_deployment",
        "link_resolver",
        "enforce_resolver"
      ]
    }
  },
  "required": [
    "parentAddress",
    "mode",
    "action"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`subdomains.transfer_item_tx`

重新验证当前 NFT 所有权，并返回一个 HTTPS 子域条目转移确认页面。

权限: transactions:request破坏性操作

输入	类型	必填
`itemAddress`	`string`	是
`newOwner`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "itemAddress": {
      "type": "string",
      "minLength": 1
    },
    "newOwner": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "itemAddress",
    "newOwner"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

TON Storage

`storage.bag_details`

读取拥有的 TON Storage Bag 的元数据和实时状态。

权限: storage:read远程读取

输入	类型	必填
`bagId`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "bagId": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "bagId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.create_bag`

根据明确的文件内容创建新的 TON Storage Bag 并做种。

权限: storage:write写入

输入	类型	必填
`name`	`string`	否
`files`	`object[]`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1
          },
          "path": {
            "type": "string",
            "minLength": 1
          },
          "text": {
            "type": "string"
          },
          "contentBase64": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "minItems": 1
    }
  },
  "required": [
    "files"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.delete_bag`

删除拥有的 TON Storage Bag 引用，并在安全时移除平台做种的字节数据。

权限: storage:delete破坏性操作

输入	类型	必填
`bagId`	`string`	是
`confirmBagId`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "bagId": {
      "type": "string",
      "minLength": 1
    },
    "confirmBagId": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "bagId",
    "confirmBagId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.list_bags`

列出已授权钱包拥有的 TON Storage Bag。

权限: storage:read远程读取

无输入参数。

JSON 输入结构

json

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.pin_bag`

通过 Bag ID 固定/导入已有的公开 TON Storage Bag。

权限: storage:write写入

输入	类型	必填
`bagId`	`string`	是
`name`	`string`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "bagId": {
      "type": "string",
      "minLength": 1
    },
    "name": {
      "type": "string"
    }
  },
  "required": [
    "bagId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.provider_funding_preview`

根据实时提供商会话，以精确整数计算资金和保障时长。

权限: storage:read远程读取

输入	类型	必填
`bagId`	`string`	是
`sessionId`	`string`	是
`targetCoverageSeconds`	`integer \| null`	是
`proofSpanSeconds`	`integer`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "bagId": {
      "type": "string",
      "minLength": 1
    },
    "sessionId": {
      "type": "string",
      "minLength": 1
    },
    "targetCoverageSeconds": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "proofSpanSeconds": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "bagId",
    "sessionId",
    "targetCoverageSeconds",
    "proofSpanSeconds"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.provider_funding_session`

为拥有的 Bag 固定一个短期有效的实时提供商和共享余额快照。

权限: storage:read远程读取

输入	类型	必填
`bagId`	`string`	是
`providerPubkeys`	`string[]`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "bagId": {
      "type": "string",
      "minLength": 1
    },
    "providerPubkeys": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 64,
        "maxLength": 64
      },
      "minItems": 1
    }
  },
  "required": [
    "bagId",
    "providerPubkeys"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.provider_operation`

读取并协调一项付费 TON Storage 提供商操作。

权限: storage:read远程读取

输入	类型	必填
`providerOperationId`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "providerOperationId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "providerOperationId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.provider_quote`

创建后端签名报价；返回提供商确认链接前会重新验证该报价。

权限: storage:read远程读取

输入	类型	必填
`bagId`	`string`	是
`sessionId`	`string`	是
`targetCoverageSeconds`	`integer \| null`	是
`proofSpanSeconds`	`integer`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "bagId": {
      "type": "string",
      "minLength": 1
    },
    "sessionId": {
      "type": "string",
      "minLength": 1
    },
    "targetCoverageSeconds": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "proofSpanSeconds": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "bagId",
    "sessionId",
    "targetCoverageSeconds",
    "proofSpanSeconds"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.providers`

列出经过后端验证、与拥有的 TON Storage Bag 兼容的提供商。

权限: storage:read远程读取

输入	类型	必填
`bagId`	`string`	是
`sort`	`"recommended" \| "cheapest" \| "uptime" \| "capacity"`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "bagId": {
      "type": "string",
      "minLength": 1
    },
    "sort": {
      "type": "string",
      "enum": [
        "recommended",
        "cheapest",
        "uptime",
        "capacity"
      ]
    }
  },
  "required": [
    "bagId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.send_bag_link_tx`

验证 Bag 和域名所有权，然后为确切的 TON Storage DNS 网站交易返回一个 HTTPS 页面。

权限: transactions:request写入

输入	类型	必填
`bagId`	`string`	是
`domain`	`string`	是

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "bagId": {
      "type": "string",
      "minLength": 1
    },
    "domain": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "bagId",
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

`storage.send_provider_tx`

重新验证实时合约、提供商、共享余额和确切金额，然后返回一个用于固定、充值、停止或提现的 HTTPS 确认页面。

权限: transactions:request破坏性操作

输入	类型	必填
`action`	`"pin" \| "top_up" \| "stop" \| "withdraw"`	是
`bagId`	`string`	是
`quoteId`	`string`	否
`targetCoverageSeconds`	`integer`	否
`providerPubkey`	`string`	否
`acknowledgeOtherProviders`	`boolean`	否

JSON 输入结构

json

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "pin",
        "top_up",
        "stop",
        "withdraw"
      ]
    },
    "bagId": {
      "type": "string",
      "minLength": 1
    },
    "quoteId": {
      "type": "string",
      "minLength": 1
    },
    "targetCoverageSeconds": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "providerPubkey": {
      "type": "string",
      "minLength": 64,
      "maxLength": 64
    },
    "acknowledgeOtherProviders": {
      "type": "boolean"
    }
  },
  "required": [
    "action",
    "bagId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}