Actions9
Overview
This node provides operations to interact with TON Jetton tokens, a type of token on the TON blockchain. It supports various token-related actions such as deploying minters, minting new tokens, transferring tokens, burning tokens, updating metadata, and trading tokens (buying/selling).
The "Transfer" operation specifically allows sending a specified amount of tokens from the user's wallet or minter contract to another recipient address. This is useful in scenarios where you want to programmatically move tokens between accounts, for example, paying another user, distributing rewards, or managing token balances within an application.
Practical examples:
- Sending tokens to a friend or service provider.
- Distributing minted tokens to multiple recipients.
- Automating token sales or transfers based on business logic.
Properties
| Name | Meaning |
|---|---|
| Minter Address | The address of the GovernanceJettonMinter contract, required if the operation involves minting or managing tokens via a minter. Format: EQ... or UQ... |
| Recipient Address | The address of the recipient who will receive the tokens. Required for mint and transfer operations. Format: EQ... or UQ... |
| Amount | The number of tokens to transfer, mint, or sell, expressed in whole units without decimals. For example, "100" means 100 tokens. |
Output
The node outputs a JSON object per input item containing the parameters used for the operation:
{
"operation": "transfer",
"minterAddress": "string", // optional, may be empty string
"recipient": "string", // recipient address for transfer
"amount": "string" // amount of tokens as string
}
This output reflects the requested operation and its parameters but does not include execution results or blockchain responses. The node does not output binary data.
Dependencies
- Requires an API key credential for TON blockchain access (configured in n8n credentials).
- The node depends on the TON network and the presence of valid minter contracts or wallets.
- Proper configuration of the TON mnemonic or authentication method is necessary to authorize token operations.
Troubleshooting
- Missing or invalid addresses: Ensure that the minter address and recipient address are correctly formatted TON addresses (starting with EQ or UQ). Invalid addresses will cause failures.
- Insufficient balance: Transfers or mints may fail if the wallet or minter does not have enough tokens or permissions.
- Operation mismatch: Using properties like recipient or amount with unsupported operations will have no effect; verify the selected operation matches the provided inputs.
- Empty required fields: For mint and transfer operations, recipient and amount must be provided; missing these will likely cause errors.
- Network issues: Connectivity problems with the TON blockchain can cause timeouts or failed requests.