Referencia de herramientas MCP

Esta referencia enumera las herramientas MCP disponibles, sus permisos y parámetros de entrada. Para conocer el comportamiento actual, consulta la lista de herramientas y respuestas de tu cliente.

Cómo leer esta referencia

Permiso es el ámbito principal requerido. Las modificaciones pueden requerir permisos adicionales para un efecto secundario confirmado, como eliminar la última asociación de un sitio o limpiar su referencia de Storage.

Cada herramienta enumera sus entradas de primer nivel. Abre el esquema JSON para ver estructuras anidadas, enumeraciones y restricciones exactas. El analizador de plantillas del backend valida el contenido de las plantillas más allá del esquema genérico de la herramienta.

Consulta confirmaciones de transacciones y restricciones de recursos para esos flujos.

Acceso y cartera

`auth.policy`

Devuelve los flujos públicos de autenticación MCP, ámbitos, controles de seguridad, retención y reglas de confirmación.

Permiso: publiclectura local

Sin parámetros de entrada.

Esquema JSON de entrada

json

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

`auth.status`

Devuelve si esta sesión MCP está autenticada.

Permiso: publiclectura local

Sin parámetros de entrada.

Esquema JSON de entrada

json

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

`mcp.access.list`

Lista los consentimientos MCP y las sesiones activas con datos sensibles ocultos de la cartera propietaria autenticada.

Permiso: mcp:readlectura remota

Sin parámetros de entrada.

Esquema JSON de entrada

json

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

`mcp.access.revoke_consent`

Revoca un consentimiento MCP por su id e invalida los tokens de acceso/renovación correspondientes.

Permiso: mcp:revokedestructiva

Entrada	Tipo	Obligatorio
`consentId`	`string`	Sí
`confirmConsentId`	`string`	Sí

Esquema JSON de entrada

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`

Lista eventos recientes de auditoría MCP con datos sensibles ocultos de la cartera propietaria autenticada.

Permiso: mcp:readlectura remota

Entrada	Tipo	Obligatorio
`limit`	`integer`	No
`method`	`string`	No
`resultStatus`	`"success" \| "error"`	No
`since`	`string`	No

Esquema JSON de entrada

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`

Devuelve métricas agregadas de auditoría MCP limitadas al propietario, sin cabeceras ni cuerpos de solicitudes sin procesar.

Permiso: mcp:readlectura remota

Entrada	Tipo	Obligatorio
`windowHours`	`integer`	No
`topMethodsLimit`	`integer`	No

Esquema JSON de entrada

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`

Devuelve el contexto de cartera del propietario/actor MCP autenticado.

Permiso: wallet:readlectura remota

Sin parámetros de entrada.

Esquema JSON de entrada

json

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

Sitios y publicaciones

`deployments.list`

Lista las publicaciones conservadas de los sitios del propietario.

Permiso: deployments:readlectura remota

Sin parámetros de entrada.

Esquema JSON de entrada

json

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

`media.upload_image`

Sube una imagen PNG, JPEG, GIF o WebP al almacén multimedia de plantillas del propietario autenticado.

Permiso: media:writeescritura

Entrada	Tipo	Obligatorio
`contentBase64`	`string`	Sí

Esquema JSON de entrada

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`

Asocia un dominio ya vinculado por DNS después de la comprobación previa. Confirma exactamente el sitio y el dominio completo. Pasa el expectedConflictSiteId revisado al mover un dominio; eliminar su sitio de origen requiere además confirmDeleteSourceSiteId y sites:delete. Todos los sitios afectados deben ser propios y estar delegados. No firma ni cambia registros DNS.

Permiso: sites:writedestructiva

Entrada	Tipo	Obligatorio
`site`	`string`	Sí
`domain`	`string`	Sí
`confirmSite`	`string`	Sí
`confirmDomain`	`string`	Sí
`expectedConflictSiteId`	`integer \| null`	No
`confirmDeleteSourceSiteId`	`integer`	No

Esquema JSON de entrada

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`

Elimina la publicación de un TON Site propio y sus archivos servidos.

Permiso: sites:deletedestructiva

Entrada	Tipo	Obligatorio
`site`	`string`	Sí
`confirmSite`	`string`	Sí

Esquema JSON de entrada

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`

Lee los metadatos de plantilla/contenido almacenados de un sitio propio.

Permiso: sites:readlectura remota

Entrada	Tipo	Obligatorio
`site`	`string`	Sí

Esquema JSON de entrada

json

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

`sites.list`

Lista los TON Sites de la cartera autorizada.

Permiso: sites:readlectura remota

Sin parámetros de entrada.

Esquema JSON de entrada

json

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

`sites.list_domains`

Lista los dominios y el estado DNS actual de un sitio propio. Acepta un nombre de sitio o un ID estable de sitio y aplica los límites de delegación de sitios/dominios.

Permiso: sites:readlectura remota

Entrada	Tipo	Obligatorio
`site`	`string`	Sí

Esquema JSON de entrada

json

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

`sites.list_releases`

Lista las versiones conservadas de un sitio propio.

Permiso: sites:readlectura remota

Entrada	Tipo	Obligatorio
`site`	`string`	Sí

Esquema JSON de entrada

json

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

`sites.preflight_domain`

Lee la propiedad actual, la vinculación DNS y los conflictos antes de asociar un .ton, .t.me o subdominio compatible a un sitio propio. No cambia ninguna asociación ni registro DNS.

Permiso: sites:readlectura remota

Entrada	Tipo	Obligatorio
`site`	`string`	Sí
`domain`	`string`	Sí

Esquema JSON de entrada

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`

Publica o actualiza un TON Site propio a partir de contenidos de archivo explícitos.

Permiso: sites:writedestructiva

Entrada	Tipo	Obligatorio
`site`	`string`	Sí
`files`	`object[]`	Sí

Esquema JSON de entrada

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`

Valida, genera y publica un TON Site basado en una plantilla.

Permiso: sites:writedestructiva

Entrada	Tipo	Obligatorio
`site`	`string`	Sí
`template`	`string`	Sí
`content`	`Valor JSON`	No

Esquema JSON de entrada

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`

Restaura un TON Site propio a una versión conservada.

Permiso: sites:rollbackdestructiva

Entrada	Tipo	Obligatorio
`site`	`string`	Sí
`releaseId`	`string`	Sí
`confirmSite`	`string`	Sí

Esquema JSON de entrada

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`

Valida la propiedad indexada y devuelve una página HTTPS donde el usuario revisa y confirma la transacción exacta de sitio TON DNS con TON Connect.

Permiso: transactions:requestescritura

Entrada	Tipo	Obligatorio
`site`	`string`	Sí

Esquema JSON de entrada

json

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

`sites.unlink_domain`

Desvincula un dominio después de que su registro DNS de sitio deje de apuntar a este sitio (o cambie de propietario). Confirma exactamente el sitio y el dominio completo. Eliminar el último dominio borra el sitio y requiere confirmDeleteSite junto con sites:delete; limpiar un sitio alojado en Storage también requiere storage:delete y delegación del Bag. No firma ni cambia registros DNS.

Permiso: sites:writedestructiva

Entrada	Tipo	Obligatorio
`site`	`string`	Sí
`domain`	`string`	Sí
`confirmSite`	`string`	Sí
`confirmDomain`	`string`	Sí
`confirmDeleteSite`	`boolean`	No

Esquema JSON de entrada

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 y nombres de usuario

`dns.lookup`

Consulta el estado y los registros públicos TON DNS de un nombre .ton.

Permiso: dns:readlectura remota

Entrada	Tipo	Obligatorio
`name`	`string`	Sí

Esquema JSON de entrada

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`

Devuelve una página HTTPS para una transacción validada de acuñación .ton, puja en subasta o liberación de un nombre caducado.

Permiso: transactions:requestescritura

Entrada	Tipo	Obligatorio
`domain`	`string`	Sí
`action`	`"mint" \| "bid" \| "release"`	Sí

Esquema JSON de entrada

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`

Revalida la propiedad indexada y devuelve una página HTTPS donde el usuario revisa y confirma la transacción exacta del registro TON DNS.

Permiso: transactions:requestescritura

Entrada	Tipo	Obligatorio
`domain`	`string`	Sí
`kind`	`"wallet" \| "site" \| "storage" \| "resolver" \| "text" \| "adnl" \| "other"`	Sí
`valueKind`	`"wallet" \| "site" \| "storage" \| "resolver" \| "text" \| "adnl" \| "other"`	No
`value`	`string \| null`	No
`rawCategory`	`string`	No
`keyName`	`string`	No

Esquema JSON de entrada

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`

Revalida de uno a cuatro nombres .ton propios y devuelve una página HTTPS para una sola confirmación TON Connect con varios mensajes.

Permiso: transactions:requestescritura

Entrada	Tipo	Obligatorio
`domains`	`string[]`	Sí

Esquema JSON de entrada

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`

Revalida la propiedad de un nombre raíz .ton o un nombre de usuario .t.me y devuelve una página HTTPS para confirmar la transferencia de su NFT a newOwner. El usuario firma en su cartera.

Permiso: transactions:requestdestructiva

Entrada	Tipo	Obligatorio
`domain`	`string`	Sí
`newOwner`	`string`	Sí

Esquema JSON de entrada

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`

Lista los dominios .ton de la cartera autorizada.

Permiso: dns:readlectura remota

Sin parámetros de entrada.

Esquema JSON de entrada

json

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

`domains.list_usernames`

Lista los nombres de usuario de Telegram .t.me de la cartera autorizada, filtrados por su delegación de dominios.

Permiso: dns:readlectura remota

Sin parámetros de entrada.

Esquema JSON de entrada

json

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

`domains.records`

Lee los registros DNS de un dominio .ton o nombre de usuario de Telegram .t.me propio.

Permiso: dns:readlectura remota

Entrada	Tipo	Obligatorio
`domain`	`string`	Sí

Esquema JSON de entrada

json

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

Subdominios

`subdomains.collection_action_tx`

Revalida los derechos actuales de la colección o del padre y devuelve una página HTTPS de confirmación de la transacción de gestión.

Permiso: transactions:requestdestructiva

Entrada	Tipo	Obligatorio
`collectionAddress`	`string`	Sí
`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"`	Sí
`accessMode`	`"public" \| "allowlist" \| "admin_only"`	No
`wallet`	`string`	No
`allowed`	`boolean`	No
`label`	`string`	No
`reserved`	`boolean`	No
`newAdmin`	`string`	No

Esquema JSON de entrada

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`

Lee la autorización actualizada de la colección y el estado de devolución del padre para la cartera autenticada.

Permiso: subdomains:readlectura remota

Entrada	Tipo	Obligatorio
`collectionAddress`	`string`	Sí

Esquema JSON de entrada

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`

Revalida la propiedad del padre, crea los metadatos de la colección y devuelve una página HTTPS de confirmación de transacción.

Permiso: transactions:requestescritura

Entrada	Tipo	Obligatorio
`parentAddress`	`string`	Sí
`mode`	`"locked" \| "linked"`	Sí
`priceGrid`	`string[]`	Sí
`minChars`	`integer`	Sí

Esquema JSON de entrada

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`

Lee una instantánea actualizada de la colección cuando la cartera autenticada tiene derechos sobre la colección o el padre.

Permiso: subdomains:readlectura remota

Entrada	Tipo	Obligatorio
`collectionAddress`	`string`	Sí

Esquema JSON de entrada

json

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

`subdomains.get_item`

Lee un elemento NFT de subdominio propiedad de la cartera autenticada.

Permiso: subdomains:readlectura remota

Entrada	Tipo	Obligatorio
`itemAddress`	`string`	Sí

Esquema JSON de entrada

json

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

`subdomains.list_collections`

Lista las colecciones de subdominios TON controladas por la cartera autenticada.

Permiso: subdomains:readlectura remota

Entrada	Tipo	Obligatorio
`limit`	`integer`	No
`cursor`	`string`	No

Esquema JSON de entrada

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`

Lista los elementos NFT de subdominios TON propiedad de la cartera autenticada.

Permiso: subdomains:readlectura remota

Entrada	Tipo	Obligatorio
`limit`	`integer`	No
`cursor`	`string`	No

Esquema JSON de entrada

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`

Revalida la disponibilidad y el acceso, genera metadatos y devuelve una página HTTPS de confirmación de acuñación o acuñación pendiente.

Permiso: transactions:requestescritura

Entrada	Tipo	Obligatorio
`collectionAddress`	`string`	Sí
`parent`	`string`	Sí
`label`	`string`	Sí
`setWalletToMinter`	`boolean`	No

Esquema JSON de entrada

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`

Vuelve a derivar una colección propia y devuelve una página HTTPS para su transacción de implementación o recuperación del resolutor.

Permiso: transactions:requestescritura

Entrada	Tipo	Obligatorio
`parentAddress`	`string`	Sí
`mode`	`"locked" \| "linked"`	Sí
`action`	`"retry_deployment" \| "link_resolver" \| "enforce_resolver"`	Sí

Esquema JSON de entrada

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`

Revalida la propiedad actual del NFT y devuelve una página HTTPS de confirmación de transferencia del elemento de subdominio.

Permiso: transactions:requestdestructiva

Entrada	Tipo	Obligatorio
`itemAddress`	`string`	Sí
`newOwner`	`string`	Sí

Esquema JSON de entrada

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`

Lee los metadatos y el estado en vivo de un Bag TON Storage propio.

Permiso: storage:readlectura remota

Entrada	Tipo	Obligatorio
`bagId`	`string`	Sí

Esquema JSON de entrada

json

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

`storage.create_bag`

Crea y comparte un nuevo Bag TON Storage a partir de contenidos de archivo explícitos.

Permiso: storage:writeescritura

Entrada	Tipo	Obligatorio
`name`	`string`	No
`files`	`object[]`	Sí

Esquema JSON de entrada

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`

Elimina una referencia a un Bag TON Storage propio y retira los bytes compartidos por la plataforma cuando es seguro.

Permiso: storage:deletedestructiva

Entrada	Tipo	Obligatorio
`bagId`	`string`	Sí
`confirmBagId`	`string`	Sí

Esquema JSON de entrada

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`

Lista los Bags TON Storage de la cartera autorizada.

Permiso: storage:readlectura remota

Sin parámetros de entrada.

Esquema JSON de entrada

json

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

`storage.pin_bag`

Fija/importa un Bag TON Storage público existente mediante su id.

Permiso: storage:writeescritura

Entrada	Tipo	Obligatorio
`bagId`	`string`	Sí
`name`	`string`	No

Esquema JSON de entrada

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`

Calcula la financiación y la cobertura exactas con aritmética entera a partir de una sesión de proveedores en vivo.

Permiso: storage:readlectura remota

Entrada	Tipo	Obligatorio
`bagId`	`string`	Sí
`sessionId`	`string`	Sí
`targetCoverageSeconds`	`integer \| null`	Sí
`proofSpanSeconds`	`integer`	Sí

Esquema JSON de entrada

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`

Fija una instantánea en vivo de corta duración de proveedores y saldo compartido para un Bag propio.

Permiso: storage:readlectura remota

Entrada	Tipo	Obligatorio
`bagId`	`string`	Sí
`providerPubkeys`	`string[]`	Sí

Esquema JSON de entrada

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`

Lee y concilia una operación de proveedor TON Storage de pago.

Permiso: storage:readlectura remota

Entrada	Tipo	Obligatorio
`providerOperationId`	`string`	Sí

Esquema JSON de entrada

json

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

`storage.provider_quote`

Crea la cotización firmada del backend que se revalidará antes de devolver un enlace de confirmación de proveedor.

Permiso: storage:readlectura remota

Entrada	Tipo	Obligatorio
`bagId`	`string`	Sí
`sessionId`	`string`	Sí
`targetCoverageSeconds`	`integer \| null`	Sí
`proofSpanSeconds`	`integer`	Sí

Esquema JSON de entrada

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`

Lista proveedores verificados por el backend compatibles con un Bag TON Storage propio.

Permiso: storage:readlectura remota

Entrada	Tipo	Obligatorio
`bagId`	`string`	Sí
`sort`	`"recommended" \| "cheapest" \| "uptime" \| "capacity"`	No

Esquema JSON de entrada

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`

Valida la propiedad del Bag y del dominio y devuelve una página HTTPS para la transacción exacta de sitio DNS TON Storage.

Permiso: transactions:requestescritura

Entrada	Tipo	Obligatorio
`bagId`	`string`	Sí
`domain`	`string`	Sí

Esquema JSON de entrada

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`

Revalida el contrato en vivo, los proveedores, el saldo compartido y el importe exacto antes de devolver una página HTTPS de confirmación para fijar, recargar, detener o retirar.

Permiso: transactions:requestdestructiva

Entrada	Tipo	Obligatorio
`action`	`"pin" \| "top_up" \| "stop" \| "withdraw"`	Sí
`bagId`	`string`	Sí
`quoteId`	`string`	No
`targetCoverageSeconds`	`integer`	No
`providerPubkey`	`string`	No
`acknowledgeOtherProviders`	`boolean`	No

Esquema JSON de entrada

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#"
}