Actions9
Overview
This node provides operations to interact with TON Jetton tokens, a token standard on the TON blockchain. It supports various token-related actions such as deploying a minter contract, retrieving and updating token metadata, minting new tokens, transferring tokens between addresses, burning tokens, and trading tokens by buying or selling.
The "Update Token Metadata" operation specifically allows users to update the metadata of an existing token via its GovernanceJettonMinter contract address. This is useful for maintaining accurate and up-to-date information about the token, such as its description or other metadata fields managed by the minter contract.
Practical examples:
- A token issuer wants to update the token's metadata after rebranding.
- A developer automates token management workflows including minting and metadata updates.
- A user transfers tokens to another wallet or sells tokens using this node.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform. Options: Deploy Minter, Get Token Metadata, Update Token Metadata, Mint, Transfer, Burn, Get Prices, Buy Tokens, Sell Tokens. |
| Minter Address | The address of the GovernanceJettonMinter contract (required for some operations like updating metadata). Format example: EQ... or UQ... |
| Recipient Address | The address of the recipient (used in mint, transfer, and sellTokens operations). Format example: EQ... or UQ... |
| Amount | The number of tokens involved in the operation, expressed as whole units without decimals (used in mint, transfer, and sellTokens operations). |
Output
The node outputs JSON data representing the parameters of the requested operation for each input item. The output JSON includes:
operation: The selected operation name.minterAddress: The provided minter contract address (if any).recipient: The recipient address (for mint, transfer, sellTokens).amount: The amount of tokens involved (for mint, transfer, sellTokens).
No binary data output is produced by this node.
Example output JSON for an "Update Token Metadata" operation:
{
"operation": "updateMetadata",
"minterAddress": "EQ..."
}
Dependencies
- Requires an API key credential for TON blockchain access (configured in n8n credentials).
- The node depends on the presence of a valid GovernanceJettonMinter contract address for operations that modify or query token metadata.
- No external libraries beyond those bundled with n8n are explicitly required.
Troubleshooting
- Missing or invalid minter address: Operations like updating metadata require a valid minter contract address. Ensure the address is correctly formatted and corresponds to a deployed GovernanceJettonMinter contract.
- Incorrect recipient address: For mint, transfer, or sell operations, verify the recipient address format and validity.
- Amount not specified or zero: When minting, transferring, or selling tokens, ensure the amount is a positive integer string.
- Credential issues: Make sure the required API authentication token or mnemonic credential is properly configured and has sufficient permissions.
- Operation not supported: Selecting an unsupported operation or missing required parameters will result in incomplete or failed execution.