Using NEAR Tokens

How to use NEAR tokens with NEAR Intents

The Verifier contract only accepts NEP-141 tokens, so native NEAR must be wrapped before depositing. The wrap.near contract converts NEAR to wNEAR at a 1:1 ratio.

See wNEAR docs for a detailed reference guide.

If you’re using the 1Click Swap API or Deposit/Withdrawal Service, wrapping is handled for you — skip this guide.

Wrap and deposit

If you’re integrating directly with the Verifier contract, you must wrap your NEAR first before depositing:

1. Wrap your NEAR

   Call near_deposit on the wrap.near contract, attaching the amount of NEAR you want to wrap. This example wraps 0.01 NEAR:

   NEAR CLI

   near call wrap.near near_deposit '{}' \
     --deposit 0.01 \
     --gas 30000000000000 \
     --useAccount your-account.near \
     --networkId mainnet
   

   NEAR API JS

   import { Account, JsonRpcProvider, teraToGas, nearToYocto, KeyPairString } from "near-api-js";
   
   const accountId = "your-account.near";
   const privateKey = "ed25519:3D4YudU..." as KeyPairString;
   
   const provider = new JsonRpcProvider({ url: "https://rpc.fastnear.com" });
   const account = new Account(accountId, provider, privateKey);
   
   await account.callFunction({
     contractId: "wrap.near",
     methodName: "near_deposit",
     args: {},
     gas: teraToGas("30"),
     deposit: nearToYocto("0.01"),
   });
   

   See contract interaction example in near-api-examples repository.

2. Deposit wNEAR into the Verifier contract

   Call ft_transfer_call on wrap.near to deposit your wNEAR. wNEAR has 24 decimals, so 0.01 wNEAR = 10000000000000000000000.

   NEAR CLI

   near call wrap.near ft_transfer_call \
     '{"receiver_id": "intents.near", "amount": "10000000000000000000000", "msg": ""}' \
     --deposit 0.000000000000000000000001 \
     --gas 100000000000000 \
     --useAccount your-account.near \
     --networkId mainnet
   

   NEAR API JS

   await account.callFunction({
     contractId: "wrap.near",
     methodName: "ft_transfer_call",
     args: {
       receiver_id: "intents.near",
       amount: "10000000000000000000000",
       msg: "",
     },
     gas: teraToGas("100"),
     deposit: 1n, // 1 yoctoNEAR
   });
   

   See contract interaction example in near-api-examples repository.

   In the Verifier contract, wrapped NEAR is identified as nep141:wrap.near.

   See Deposits for details on the msg parameter and other deposit options.