How to create jetton transfer?

[mahnunchik]

Could you please provide sample code (in the Readme?) how to create jetton/token transfer transactio?

[vserpokryl]

@mahnunchik

I think this is useful for you.
Links:

• https://docs.ton.org/develop/dapps/cookbook#how-to-construct-a-message-for-a-jetton-transfer-with-a-comment

import { beginCell, Address, TonClient, WalletContractV4, internal, external, storeMessage, toNano } from '@ton/ton';
import nacl from 'tweetnacl';

const apiKey = '...';
const client = new TonClient({ endpoint: 'https://toncenter.com/api/v2/jsonRPC', apiKey });

const usdtTokenContractAddress = 'EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs';
const toAddress = 'UQBcGtGIHLIQJuUHRRfWLhQxUJF4p49ywJyBdDr7UKTK60p9';

async function getUserJettonWalletAddress(userAddress: string, jettonMasterAddress: string) {
  const userAddressCell = beginCell().storeAddress(Address.parse(userAddress)).endCell();

  const response = await client.runMethod(Address.parse(jettonMasterAddress), 'get_wallet_address', [
    { type: 'slice', cell: userAddressCell },
  ]);

  return response.stack.readAddress();
}

(async () => {
  // Generate keyPair from mnemonic/secret key
  const keyPair = nacl.sign.keyPair.fromSecretKey(Buffer.from('SecretKey', 'hex'));
  const secretKey = Buffer.from(keyPair.secretKey);
  const publicKey = Buffer.from(keyPair.publicKey);

  const workchain = 0; // Usually you need a workchain 0
  const wallet = WalletContractV4.create({ workchain, publicKey });
  const address = wallet.address.toString({ urlSafe: true, bounceable: false, testOnly: false });
  const contract = client.open(wallet);

  const balance = await contract.getBalance();
  console.log({ address, balance });

  const seqno = await contract.getSeqno();
  console.log({ address, seqno });

  const { init } = contract;
  const contractDeployed = await client.isContractDeployed(Address.parse(address));
  let neededInit: null | typeof init = null;

  if (init && !contractDeployed) {
    neededInit = init;
  }

  const jettonWalletAddress = await getUserJettonWalletAddress(address, usdtTokenContractAddress);

  // Comment payload
  // const forwardPayload = beginCell()
  //   .storeUint(0, 32) // 0 opcode means we have a comment
  //   .storeStringTail('Hello, TON!')
  //   .endCell();

  const messageBody = beginCell()
    .storeUint(0x0f8a7ea5, 32) // opcode for jetton transfer
    .storeUint(0, 64) // query id
    .storeCoins(5001) // jetton amount, amount * 10^9
    .storeAddress(toAddress)
    .storeAddress(toAddress) // response destination
    .storeBit(0) // no custom payload
    .storeCoins(0) // forward amount - if > 0, will send notification message
    .storeBit(0) // we store forwardPayload as a reference, set 1 and uncomment next line for have a comment
    // .storeRef(forwardPayload)
    .endCell();

  const internalMessage = internal({
    to: jettonWalletAddress,
    value: toNano('0.1'),
    bounce: true,
    body: messageBody,
  });

  const body = wallet.createTransfer({
    seqno,
    secretKey,
    messages: [internalMessage],
  });

  const externalMessage = external({
    to: address,
    init: neededInit,
    body,
  });

  const externalMessageCell = beginCell().store(storeMessage(externalMessage)).endCell();

  const signedTransaction = externalMessageCell.toBoc();
  const hash = externalMessageCell.hash().toString('hex');

  console.log('hash:', hash);

  await client.sendFile(signedTransaction);
})();

[vserpokryl]

If you need sync method of getUserJettonWalletAddress look: https://docs.ton.org/develop/dapps/cookbook#how-to-calculate-users-jetton-wallet-address-offline

[Jobians]

@mahnunchik

I think this is useful for you. Links:

• https://docs.ton.org/develop/dapps/cookbook#how-to-construct-a-message-for-a-jetton-transfer-with-a-comment

import { beginCell, Address, TonClient, WalletContractV4, internal, external, storeMessage, toNano } from '@ton/ton';
import nacl from 'tweetnacl';

const apiKey = '...';
const client = new TonClient({ endpoint: 'https://toncenter.com/api/v2/jsonRPC', apiKey });

const usdtTokenContractAddress = 'EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs';
const toAddress = 'UQBcGtGIHLIQJuUHRRfWLhQxUJF4p49ywJyBdDr7UKTK60p9';

async function getUserJettonWalletAddress(userAddress: string, jettonMasterAddress: string) {
  const userAddressCell = beginCell().storeAddress(Address.parse(userAddress)).endCell();

  const response = await client.runMethod(Address.parse(jettonMasterAddress), 'get_wallet_address', [
    { type: 'slice', cell: userAddressCell },
  ]);

  return response.stack.readAddress();
}

(async () => {
  // Generate keyPair from mnemonic/secret key
  const keyPair = nacl.sign.keyPair.fromSecretKey(Buffer.from('SecretKey', 'hex'));
  const secretKey = Buffer.from(keyPair.secretKey);
  const publicKey = Buffer.from(keyPair.publicKey);

  const workchain = 0; // Usually you need a workchain 0
  const wallet = WalletContractV4.create({ workchain, publicKey });
  const address = wallet.address.toString({ urlSafe: true, bounceable: false, testOnly: false });
  const contract = client.open(wallet);

  const balance = await contract.getBalance();
  console.log({ address, balance });

  const seqno = await contract.getSeqno();
  console.log({ address, seqno });

  const { init } = contract;
  const contractDeployed = await client.isContractDeployed(Address.parse(address));
  let neededInit: null | typeof init = null;

  if (init && !contractDeployed) {
    neededInit = init;
  }

  const jettonWalletAddress = await getUserJettonWalletAddress(address, usdtTokenContractAddress);

  // Comment payload
  // const forwardPayload = beginCell()
  //   .storeUint(0, 32) // 0 opcode means we have a comment
  //   .storeStringTail('Hello, TON!')
  //   .endCell();

  const messageBody = beginCell()
    .storeUint(0x0f8a7ea5, 32) // opcode for jetton transfer
    .storeUint(0, 64) // query id
    .storeCoins(5001) // jetton amount, amount * 10^9
    .storeAddress(toAddress)
    .storeAddress(toAddress) // response destination
    .storeBit(0) // no custom payload
    .storeCoins(0) // forward amount - if > 0, will send notification message
    .storeBit(0) // we store forwardPayload as a reference, set 1 and uncomment next line for have a comment
    // .storeRef(forwardPayload)
    .endCell();

  const internalMessage = internal({
    to: jettonWalletAddress,
    value: toNano('0.1'),
    bounce: true,
    body: messageBody,
  });

  const body = wallet.createTransfer({
    seqno,
    secretKey,
    messages: [internalMessage],
  });

  const externalMessage = external({
    to: address,
    init: neededInit,
    body,
  });

  const externalMessageCell = beginCell().store(storeMessage(externalMessage)).endCell();

  const signedTransaction = externalMessageCell.toBoc();
  const hash = externalMessageCell.hash().toString('hex');

  console.log('hash:', hash);

  await client.sendFile(signedTransaction);
})();

Error

'LITE_SERVER_UNKNOWN: cannot apply external message to current state : External message was not accepted

[Aero25x]

If you still cant transfer jettons, here is project which do it.
https://github.com/dry-com/kozel

[LI-YONG-QI]

@vserpokryl Hello, I have a question about Jetton transfer code, why do I need to use wallet.createTransfer before external ? And where can I find more details about this ?

[vserpokryl]

@LI-YONG-QI wallet.createTransfer is body for external message in this case. You can just put createTransfer into external message body, like this:

const externalMessage = external({
  to: address,
  init: neededInit,
  body: wallet.createTransfer({
    seqno,
    secretKey,
    messages: [internalMessage],
  }),
});

[LI-YONG-QI]

@vserpokryl Thanks for your response

Here is the source code of createWalletTransferV4 (from createTransfer)

export function createWalletTransferV4<T extends Wallet4SendArgsSignable | Wallet4SendArgsSigned>(
    args: T & { sendMode: number, walletId: number }
) {

    // Check number of messages
    if (args.messages.length > 4) {
        throw Error("Maximum number of messages in a single transfer is 4");
    }

    let signingMessage = beginCell()
        .storeUint(args.walletId, 32);
    if (args.seqno === 0) {
        for (let i = 0; i < 32; i++) {
            signingMessage.storeBit(1);
        }
    } else {
        signingMessage.storeUint(args.timeout || Math.floor(Date.now() / 1e3) + 60, 32); // Default timeout: 60 seconds
    }
    signingMessage.storeUint(args.seqno, 32);
    signingMessage.storeUint(0, 8); // Simple order
    for (let m of args.messages) {
        signingMessage.storeUint(args.sendMode, 8);
        signingMessage.storeRef(beginCell().store(storeMessageRelaxed(m)));
    }
 
    return signPayload(
        args,
        signingMessage,
        packSignatureToFront,
    ) as T extends Wallet4SendArgsSignable ? Promise<Cell> : Cell;
}

I knew the Cell was serialized by TL-B scheme in TON, but I don't know what is TL-B scheme of this Cell in createWalletTransferV4

[immujahidkhan]

import "@stdlib/deploy";
import "./google";
message MyTransfer {
amount: Int as coins;
}

contract InitiateJettonTransfer with Deployable {
masterAddress: Address;
recipientAddress: Address;
// Initialize with the master contract address, the recipient, and the amount of Jettons
init(master: Address, recipient: Address){
self.masterAddress = master;
self.recipientAddress = recipient;
}

fun getJettonWalletAddress(user: Address): Address {
    let walletInit: StateInit = initOf JettonDefaultWallet(self.masterAddress, user);
    return contractAddress(walletInit);
}

// Method to initiate the transfer of Jettons

receive(msg: MyTransfer){
    let senderWallet: Address = self.getJettonWalletAddress(sender());
    // Construct the TokenTransfer message using the provided message type
    let transferMessage: TokenTransfer = TokenTransfer{
        queryId: 0, // Set query ID to 0
        amount: msg.amount, // The amount of Jettons to transfer
        destination: myAddress(), // Destination address for Jettons
        response_destination: myAddress(), // Response destination (optional)
        custom_payload: null, // No custom payload
        forward_ton_amount: 0, // Forward TON amount (optional, set to 0)
        forward_payload: emptySlice() // Empty forward payload (optional)
    };
    // Send the transfer message to the sender's wallet
    send(SendParameters{
            to: senderWallet,
            value: ton("0.05"), // Gas fee
            bounce: true,
            body: transferMessage.toCell() // Convert the message to a Cell and send it
        }
    );
}

get fun contractBalance(): Int {
    // This should ideally return the balance of Jettons this contract has received
    return myBalance();
}

}

I tried this but my transaction still failed how to fix?
https://testnet.tonviewer.com/kQDmdvV_XTLbQWFJTJShJE36zPlbJHxlURoPXImn0xyyN6hw

[Omokami]

When you run the above code, the following error occurs.

contractDeployed false;
POST https://toncenter.com/api/v2/jsonRPC 500 (Internal Server Error)

Can you help me?

[ilaziness]

https://github.com/toncenter/examples/blob/main/withdrawals-jettons.js

[Omokami]

@vserpokryl

I solved the problem

Thank you

[Tvenus]

@Omokami

You are great!!!

[Omokami]

@vserpokryl

Hello

I need urgent help on how to import my Jetton transaction history

[vserpokryl]

@Omokami, hello! You can use https://tonapi.io for this. For example getAccountJettonsHistory - https://tonapi.io/api-v2#operations-Accounts-getAccountJettonsHistory

[Omokami]

@vserpokryl

Thank you

but, I would appreciate it if you could explain how to get the account ID and jetton ID.

[vserpokryl]

@Omokami
account_id - your ton address
jetton_id - contract address (jetton master address) of token (Jetton) (for example USDT - EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs)

If you need all history of jetton transfers for all tokens use getAccountJettonsHistory (/v2/accounts/{account_id}/jettons/history)
If you need history for specific Jetton (USDT for example) use getAccountJettonHistoryByID (/v2/accounts/{account_id}/jettons/{jetton_id}/history)

[Omokami]

@vserpokryl

https://tonapi.io/api/v2/accounts/EQAZ3iBMMvTmQmBSJWtQW6ISeu9Qmiiqs2cq_aionprmhXfw/jettons/history
same
How to solve? @

[vserpokryl]

@Omokami
Check the specifications here https://tonapi.io/api-v2#operations-Accounts-getAccountJettonsHistory (expand the route and check details)
https://tonapi.io/v2/accounts/EQAZ3iBMMvTmQmBSJWtQW6ISeu9Qmiiqs2cq_aionprmhXfw/jettons/history?limit=100

[Omokami]

@vserpokryl

Thank you very much