Riferimento degli strumenti MCP

Questa pagina elenca gli strumenti MCP disponibili, i permessi e i parametri di input. Per il comportamento attuale, consulta l’elenco degli strumenti e le risposte del tuo client.

Come leggere questo riferimento

Permesso è l'ambito principale richiesto. Le modifiche possono richiedere permessi aggiuntivi per un effetto secondario confermato, come eliminare l'ultima associazione di un sito o rimuoverne il riferimento Storage.

Ogni strumento elenca i suoi input di primo livello. Apri lo schema JSON per strutture annidate, enumerazioni e vincoli esatti. Il contenuto dei modelli viene validato dal parser dei modelli del backend oltre lo schema generico dello strumento.

Consulta conferme delle transazioni e restrizioni sulle risorse per questi flussi.

Accesso e wallet

`auth.policy`

Restituisce flussi pubblici di autenticazione MCP, ambiti, controlli di sicurezza, conservazione e regole di conferma.

Permesso: publiclettura locale

Nessun parametro di input.

Schema JSON di input

json

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

`auth.status`

Restituisce se questa sessione MCP è autenticata.

Permesso: publiclettura locale

Nessun parametro di input.

Schema JSON di input

json

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

`mcp.access.list`

Elenca consensi MCP e sessioni attive con dati sensibili oscurati del wallet proprietario autenticato.

Permesso: mcp:readlettura remota

Nessun parametro di input.

Schema JSON di input

json

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

`mcp.access.revoke_consent`

Revoca un consenso MCP tramite id e invalida i token di accesso/rinnovo corrispondenti.

Permesso: mcp:revokedistruttiva

Input	Tipo	Obbligatorio
`consentId`	`string`	Sì
`confirmConsentId`	`string`	Sì

Schema JSON di input

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`

Elenca i recenti eventi di audit MCP con dati sensibili oscurati del wallet proprietario autenticato.

Permesso: mcp:readlettura remota

Input	Tipo	Obbligatorio
`limit`	`integer`	No
`method`	`string`	No
`resultStatus`	`"success" \| "error"`	No
`since`	`string`	No

Schema JSON di input

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`

Restituisce metriche aggregate di audit MCP limitate al proprietario, senza intestazioni o corpi delle richieste grezzi.

Permesso: mcp:readlettura remota

Input	Tipo	Obbligatorio
`windowHours`	`integer`	No
`topMethodsLimit`	`integer`	No

Schema JSON di input

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`

Restituisce il contesto del wallet del proprietario/attore MCP autenticato.

Permesso: wallet:readlettura remota

Nessun parametro di input.

Schema JSON di input

json

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

Siti e pubblicazioni

`deployments.list`

Elenca le pubblicazioni conservate nei siti del proprietario.

Permesso: deployments:readlettura remota

Nessun parametro di input.

Schema JSON di input

json

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

`media.upload_image`

Carica un’immagine PNG, JPEG, GIF o WebP nell’archivio multimediale dei modelli del proprietario autenticato.

Permesso: media:writescrittura

Input	Tipo	Obbligatorio
`contentBase64`	`string`	Sì

Schema JSON di input

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`

Associa un dominio già collegato tramite DNS dopo la verifica preliminare. Conferma esattamente sito e dominio completo. Passa l’expectedConflictSiteId esaminato quando sposti un dominio; eliminare il sito di origine richiede anche confirmDeleteSourceSiteId e sites:delete. Tutti i siti interessati devono essere posseduti e delegati. Non firma né modifica record DNS.

Permesso: sites:writedistruttiva

Input	Tipo	Obbligatorio
`site`	`string`	Sì
`domain`	`string`	Sì
`confirmSite`	`string`	Sì
`confirmDomain`	`string`	Sì
`expectedConflictSiteId`	`integer \| null`	No
`confirmDeleteSourceSiteId`	`integer`	No

Schema JSON di input

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 pubblicazione di un TON Site posseduto e i file serviti.

Permesso: sites:deletedistruttiva

Input	Tipo	Obbligatorio
`site`	`string`	Sì
`confirmSite`	`string`	Sì

Schema JSON di input

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`

Legge i metadati memorizzati di modello/contenuto di un sito posseduto.

Permesso: sites:readlettura remota

Input	Tipo	Obbligatorio
`site`	`string`	Sì

Schema JSON di input

json

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

`sites.list`

Elenca i TON Sites posseduti dal wallet autorizzato.

Permesso: sites:readlettura remota

Nessun parametro di input.

Schema JSON di input

json

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

`sites.list_domains`

Elenca i domini e lo stato DNS attuale di un sito posseduto. Accetta un nome del sito o un ID stabile del sito e applica i limiti di delega di siti/domini.

Permesso: sites:readlettura remota

Input	Tipo	Obbligatorio
`site`	`string`	Sì

Schema JSON di input

json

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

`sites.list_releases`

Elenca le versioni conservate di un sito posseduto.

Permesso: sites:readlettura remota

Input	Tipo	Obbligatorio
`site`	`string`	Sì

Schema JSON di input

json

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

`sites.preflight_domain`

Legge proprietà attuale, collegamento DNS e conflitti prima di associare un .ton, .t.me o sottodominio supportato a un sito posseduto. Non modifica alcuna associazione o record DNS.

Permesso: sites:readlettura remota

Input	Tipo	Obbligatorio
`site`	`string`	Sì
`domain`	`string`	Sì

Schema JSON di input

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`

Pubblica o aggiorna un TON Site posseduto a partire da contenuti di file espliciti.

Permesso: sites:writedistruttiva

Input	Tipo	Obbligatorio
`site`	`string`	Sì
`files`	`object[]`	Sì

Schema JSON di input

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 e pubblica un TON Site basato su un modello.

Permesso: sites:writedistruttiva

Input	Tipo	Obbligatorio
`site`	`string`	Sì
`template`	`string`	Sì
`content`	`Valore JSON`	No

Schema JSON di input

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`

Ripristina un TON Site posseduto a una versione conservata.

Permesso: sites:rollbackdistruttiva

Input	Tipo	Obbligatorio
`site`	`string`	Sì
`releaseId`	`string`	Sì
`confirmSite`	`string`	Sì

Schema JSON di input

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 proprietà indicizzata e restituisce una pagina HTTPS in cui l’utente controlla e conferma l’esatta transazione di sito TON DNS con TON Connect.

Permesso: transactions:requestscrittura

Input	Tipo	Obbligatorio
`site`	`string`	Sì

Schema JSON di input

json

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

`sites.unlink_domain`

Scollega un dominio dopo che il suo record DNS di sito non punta più a questo sito (o ha cambiato proprietario). Conferma esattamente sito e dominio completo. Rimuovere l’ultimo dominio elimina il sito e richiede confirmDeleteSite e sites:delete; la pulizia di un sito ospitato su Storage richiede anche storage:delete e delega del Bag. Non firma né modifica record DNS.

Permesso: sites:writedistruttiva

Input	Tipo	Obbligatorio
`site`	`string`	Sì
`domain`	`string`	Sì
`confirmSite`	`string`	Sì
`confirmDomain`	`string`	Sì
`confirmDeleteSite`	`boolean`	No

Schema JSON di input

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 e nomi utente

`dns.lookup`

Consulta stato e record pubblici TON DNS di un nome .ton.

Permesso: dns:readlettura remota

Input	Tipo	Obbligatorio
`name`	`string`	Sì

Schema JSON di input

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`

Restituisce una pagina HTTPS per una transazione validata di conio .ton, offerta d’asta o rilascio di un nome scaduto.

Permesso: transactions:requestscrittura

Input	Tipo	Obbligatorio
`domain`	`string`	Sì
`action`	`"mint" \| "bid" \| "release"`	Sì

Schema JSON di input

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`

Rivalida la proprietà indicizzata e restituisce una pagina HTTPS in cui l’utente controlla e conferma l’esatta transazione del record TON DNS.

Permesso: transactions:requestscrittura

Input	Tipo	Obbligatorio
`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

Schema JSON di input

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`

Rivalida da uno a quattro nomi .ton posseduti e restituisce una pagina HTTPS per una singola conferma TON Connect con più messaggi.

Permesso: transactions:requestscrittura

Input	Tipo	Obbligatorio
`domains`	`string[]`	Sì

Schema JSON di input

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`

Rivalida la proprietà di un nome radice .ton o di un nome utente .t.me e restituisce una pagina HTTPS per confermare il trasferimento del suo NFT a newOwner. L’utente firma nel wallet.

Permesso: transactions:requestdistruttiva

Input	Tipo	Obbligatorio
`domain`	`string`	Sì
`newOwner`	`string`	Sì

Schema JSON di input

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`

Elenca i domini .ton posseduti dal wallet autorizzato.

Permesso: dns:readlettura remota

Nessun parametro di input.

Schema JSON di input

json

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

`domains.list_usernames`

Elenca i nomi utente Telegram .t.me posseduti dal wallet autorizzato, filtrati in base alla sua delega dei domini.

Permesso: dns:readlettura remota

Nessun parametro di input.

Schema JSON di input

json

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

`domains.records`

Legge i record DNS di un dominio .ton o di un nome utente Telegram .t.me posseduto.

Permesso: dns:readlettura remota

Input	Tipo	Obbligatorio
`domain`	`string`	Sì

Schema JSON di input

json

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

Sottodomini

`subdomains.collection_action_tx`

Rivalida i diritti attuali della collezione o del padre e restituisce una pagina HTTPS di conferma della transazione di gestione.

Permesso: transactions:requestdistruttiva

Input	Tipo	Obbligatorio
`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

Schema JSON di input

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`

Legge l’autorizzazione aggiornata della collezione e lo stato di restituzione del padre per il wallet autenticato.

Permesso: subdomains:readlettura remota

Input	Tipo	Obbligatorio
`collectionAddress`	`string`	Sì

Schema JSON di input

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`

Rivalida la proprietà del padre, crea i metadati della collezione e restituisce una pagina HTTPS di conferma della transazione.

Permesso: transactions:requestscrittura

Input	Tipo	Obbligatorio
`parentAddress`	`string`	Sì
`mode`	`"locked" \| "linked"`	Sì
`priceGrid`	`string[]`	Sì
`minChars`	`integer`	Sì

Schema JSON di input

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`

Legge un’istantanea aggiornata della collezione quando il wallet autenticato detiene diritti sulla collezione o sul padre.

Permesso: subdomains:readlettura remota

Input	Tipo	Obbligatorio
`collectionAddress`	`string`	Sì

Schema JSON di input

json

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

`subdomains.get_item`

Legge un elemento NFT di sottodominio posseduto dal wallet autenticato.

Permesso: subdomains:readlettura remota

Input	Tipo	Obbligatorio
`itemAddress`	`string`	Sì

Schema JSON di input

json

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

`subdomains.list_collections`

Elenca le collezioni di sottodomini TON controllate dal wallet autenticato.

Permesso: subdomains:readlettura remota

Input	Tipo	Obbligatorio
`limit`	`integer`	No
`cursor`	`string`	No

Schema JSON di input

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`

Elenca gli elementi NFT di sottodomini TON posseduti dal wallet autenticato.

Permesso: subdomains:readlettura remota

Input	Tipo	Obbligatorio
`limit`	`integer`	No
`cursor`	`string`	No

Schema JSON di input

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`

Rivalida disponibilità e accesso, genera i metadati e restituisce una pagina HTTPS di conferma del conio o del conio in attesa.

Permesso: transactions:requestscrittura

Input	Tipo	Obbligatorio
`collectionAddress`	`string`	Sì
`parent`	`string`	Sì
`label`	`string`	Sì
`setWalletToMinter`	`boolean`	No

Schema JSON di input

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`

Rideriva una collezione posseduta e restituisce una pagina HTTPS per la sua transazione di deployment o recupero del resolver.

Permesso: transactions:requestscrittura

Input	Tipo	Obbligatorio
`parentAddress`	`string`	Sì
`mode`	`"locked" \| "linked"`	Sì
`action`	`"retry_deployment" \| "link_resolver" \| "enforce_resolver"`	Sì

Schema JSON di input

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`

Rivalida la proprietà attuale dell’NFT e restituisce una pagina HTTPS di conferma del trasferimento dell’elemento di sottodominio.

Permesso: transactions:requestdistruttiva

Input	Tipo	Obbligatorio
`itemAddress`	`string`	Sì
`newOwner`	`string`	Sì

Schema JSON di input

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`

Legge metadati e stato dal vivo di un Bag TON Storage posseduto.

Permesso: storage:readlettura remota

Input	Tipo	Obbligatorio
`bagId`	`string`	Sì

Schema JSON di input

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 e condivide un nuovo Bag TON Storage da contenuti di file espliciti.

Permesso: storage:writescrittura

Input	Tipo	Obbligatorio
`name`	`string`	No
`files`	`object[]`	Sì

Schema JSON di input

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 un riferimento a un Bag TON Storage posseduto e rimuove i byte condivisi dalla piattaforma quando è sicuro.

Permesso: storage:deletedistruttiva

Input	Tipo	Obbligatorio
`bagId`	`string`	Sì
`confirmBagId`	`string`	Sì

Schema JSON di input

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`

Elenca i Bag TON Storage posseduti dal wallet autorizzato.

Permesso: storage:readlettura remota

Nessun parametro di input.

Schema JSON di input

json

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

`storage.pin_bag`

Fissa/importa un Bag TON Storage pubblico esistente tramite il suo id.

Permesso: storage:writescrittura

Input	Tipo	Obbligatorio
`bagId`	`string`	Sì
`name`	`string`	No

Schema JSON di input

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`

Calcola finanziamento e copertura esatti con aritmetica intera da una sessione di provider dal vivo.

Permesso: storage:readlettura remota

Input	Tipo	Obbligatorio
`bagId`	`string`	Sì
`sessionId`	`string`	Sì
`targetCoverageSeconds`	`integer \| null`	Sì
`proofSpanSeconds`	`integer`	Sì

Schema JSON di input

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`

Fissa un’istantanea dal vivo di breve durata di provider e saldo condiviso per un Bag posseduto.

Permesso: storage:readlettura remota

Input	Tipo	Obbligatorio
`bagId`	`string`	Sì
`providerPubkeys`	`string[]`	Sì

Schema JSON di input

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`

Legge e riconcilia un’operazione di provider TON Storage a pagamento.

Permesso: storage:readlettura remota

Input	Tipo	Obbligatorio
`providerOperationId`	`string`	Sì

Schema JSON di input

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 il preventivo firmato dal backend che verrà rivalidato prima di restituire un link di conferma del provider.

Permesso: storage:readlettura remota

Input	Tipo	Obbligatorio
`bagId`	`string`	Sì
`sessionId`	`string`	Sì
`targetCoverageSeconds`	`integer \| null`	Sì
`proofSpanSeconds`	`integer`	Sì

Schema JSON di input

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`

Elenca i provider verificati dal backend compatibili con un Bag TON Storage posseduto.

Permesso: storage:readlettura remota

Input	Tipo	Obbligatorio
`bagId`	`string`	Sì
`sort`	`"recommended" \| "cheapest" \| "uptime" \| "capacity"`	No

Schema JSON di input

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 proprietà del Bag e del dominio, poi restituisce una pagina HTTPS per l’esatta transazione di sito DNS TON Storage.

Permesso: transactions:requestscrittura

Input	Tipo	Obbligatorio
`bagId`	`string`	Sì
`domain`	`string`	Sì

Schema JSON di input

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`

Rivalida il contratto dal vivo, i provider, il saldo condiviso e l’importo esatto prima di restituire una pagina HTTPS di conferma di pin, ricarica, arresto o prelievo.

Permesso: transactions:requestdistruttiva

Input	Tipo	Obbligatorio
`action`	`"pin" \| "top_up" \| "stop" \| "withdraw"`	Sì
`bagId`	`string`	Sì
`quoteId`	`string`	No
`targetCoverageSeconds`	`integer`	No
`providerPubkey`	`string`	No
`acknowledgeOtherProviders`	`boolean`	No

Schema JSON di input

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