NEAR Intents Examples

Example scripts demonstrating cross-chain token operations with NEAR Intents. Two integration paths are covered:

• 1-Click API — simple REST-based flow for cross-chain swaps (no wallet SDK required)
• Intents SDK — full programmatic access to deposits, swaps, transfers, and withdrawals inside the intents system

Prerequisites

• Node.js >= 16
• pnpm >= 8
• A NEAR account or an EVM wallet with a private key
• (Optional) 1-Click JWT token — request here
  • Without a JWT you will pay a 0.1% fee on all swaps

Setup

1. Clone and install

   git clone https://github.com/near-examples/near-intents-examples
   cd near-intents-examples
   pnpm install

2. Environment variables

   Copy .env.example to .env and fill in your credentials:

   # 1-Click API examples (NEAR wallet only)
   SENDER_NEAR_ACCOUNT=your-account.near
   SENDER_PRIVATE_KEY=ed25519:5D9PZd2a...
   ONE_CLICK_JWT=eyJhbGciOiJSUzI1N....
   
   # SDK examples (NEAR or EVM — set one)
   INTENTS_SDK_PRIVATE_KEY_NEAR=ed25519:5D9PZd2a...
   INTENTS_SDK_PRIVATE_KEY_EVM=0x...

Project Structure

near-intents-examples/
├── 1click-example/              # REST-based 1-Click API examples
│   ├── 1-get-tokens.ts          # Fetch supported tokens list
│   ├── 2-get-quote.ts           # Get swap quote with deposit address
│   ├── 3-send-deposit.ts        # Send tokens to deposit address
│   ├── 4-submit-tx-hash-OPTIONAL.ts  # Submit tx hash for faster processing
│   ├── 5-check-status-OPTIONAL.ts    # Poll swap status until completion
│   ├── 6-full-swap.ts           # End-to-end swap (steps 2-5 combined)
│   ├── near.ts                  # NEAR account setup
│   └── utils.ts                 # Display helpers
│
├── verifier-examples/                    # Intents SDK examples (auto-detects NEAR or EVM signer)
│   ├── get-tokens-list.ts           # Fetch all supported tokens across chains
│   ├── get-intents-account-id.ts    # Derive intents-internal account ID from wallet
│   ├── get-balances.ts              # Read token balances from intents contract
│   ├── get-token-deposit-address.ts # Get deposit address to fund intents account
│   ├── get-public-key-near.ts       # Check public key registration status (NEAR only)
│   ├── add-public-key-near.ts       # Register public key with intents.near (NEAR only)
│   ├── swap-tokens-near.ts          # Swap tokens with NEP-413 signing (NEAR)
│   ├── swap-tokens-evm.ts           # Swap tokens with ERC-191 signing (EVM)
│   ├── transfer-tokens.ts           # Internal transfer between intents accounts
│   ├── withdraw-tokens.ts           # Withdraw tokens to external chain address
│   └── utils/                       # Shared configuration and signer setup
│       ├── config.ts                # SDK instance & RPC provider
│       ├── signer.ts                # Auto-detect NEAR or EVM signer from .env
│       ├── near-config.ts           # NEAR wallet & NEP-413 signer setup
│       ├── evm-config.ts            # EVM wallet & ERC-191 signer setup
│       └── chains.ts                # Chain name ↔ BlockchainEnum mapping
│
├── .env.example                 # Environment variable template
└── package.json

Dependencies

Package	Purpose
@defuse-protocol/one-click-sdk-typescript	1-Click REST API client (quotes, status, token list)
@defuse-protocol/intents-sdk	Intents SDK for signing, submitting, and settling intents
@defuse-protocol/internal-utils	Auth identity, message factories, POA bridge client
near-api-js	NEAR blockchain interaction (RPC, accounts, NEP-413 signing)
viem	EVM wallet client and ERC-191 message signing
zod	Runtime response validation and type inference
@scure/base	Base64 encoding/decoding for signatures and nonces
dotenv	Environment variable loading

---

1-Click API Examples

The 1-Click API is the simplest integration path. You request a quote, send tokens to a deposit address, and the system handles the cross-chain swap.

Swap Flow

1. Get quote — receive pricing, fees, and a unique depositAddress
2. Send deposit — transfer tokens to the depositAddress on the origin chain
3. Intent execution — 1-Click handles the swap via NEAR Intents
4. (Optional) Submit the tx hash for faster detection
5. (Optional) Poll status until SUCCESS or REFUNDED

Running the Examples

pnpm 1click/get-tokens        # List supported tokens (no auth required)
pnpm 1click/get-quote          # Get a swap quote
pnpm 1click/send-deposit       # Send deposit to quote address
pnpm 1click/submit-tx-hash     # Submit tx hash (optional, speeds up processing)
pnpm 1click/check-status       # Poll swap status (optional)
pnpm 1click/full-swap           # Full end-to-end swap (steps 2-5 combined)

Configuring a Swap

Edit the configuration variables at the top of 2-get-quote.ts or 6-full-swap.ts:

const isTest = true;           // true = dry run (no deposit address), false = real execution
const originAsset = 'nep141:wrap.near';                                           // Source token
const destinationAsset = 'nep141:arb-0x912ce59144191c1204e64559fe8253a0e49e6548.omft.near'; // Target token
const amount = NEAR.toUnits('0.5').toString();                                    // Amount in smallest unit

Status Codes

Status	Description
PENDING_DEPOSIT	Waiting for deposit confirmation
KNOWN_DEPOSIT_TX	Deposit transaction detected
PROCESSING	Swap being executed
SUCCESS	Swap completed
REFUNDED	Swap failed, tokens refunded

---

SDK Examples

The Intents SDK gives full control over the intents system. Tokens are deposited into an intents account first, then swapped, transferred, or withdrawn programmatically.

Most scripts auto-detect your signer type (NEAR or EVM) based on which private key is set in .env. Swap scripts are split by signer type since the signing logic differs.

Running the Examples

# Read-only (no wallet required)
pnpm sdk/get-tokens-list             # List all supported tokens across chains

# Account & Balances (auto-detects NEAR or EVM signer)
pnpm sdk/get-intents-account-id      # Derive your intents-internal account ID
pnpm sdk/get-balances                # Check token balances in your intents account
pnpm sdk/get-token-deposit-address   # Get a deposit address to fund your intents account

# Public Key Management (NEAR only)
pnpm sdk/get-public-key-near         # Check if your key is registered with intents.near
pnpm sdk/add-public-key-near         # Register your key (one-time, required before signing)

# Swap Tokens (pick the one matching your wallet)
pnpm sdk/swap-tokens-near            # Swap using NEAR wallet (NEP-413 signing)
pnpm sdk/swap-tokens-evm             # Swap using EVM wallet (ERC-191 signing)

# Move Tokens (auto-detects signer)
pnpm sdk/transfer-tokens             # Internal transfer to another intents account
pnpm sdk/withdraw-tokens             # Withdraw tokens to an external chain address

Typical Workflow

1. Get your internal address — derive the intents account ID from your NEAR or EVM credentials
2. Get a deposit address — request a chain-specific address to fund your intents account
3. Deposit tokens — send tokens from your external wallet to the deposit address
4. Check balances — verify tokens arrived in your intents account
5. Swap / Transfer / Withdraw — perform operations inside the system

---

Learn More

• NEAR Intents Docs
• 1-Click API Reference
• 1-Click TypeScript SDK
• NEAR Intents Explorer
• NEAR Protocol Docs

Contributing

Contributions are welcome. Before submitting a PR, make sure your code passes linting:

pnpm lint        # check for issues
pnpm lint:fix    # auto-fix issues
pnpm format      # format with Prettier

License

This project is provided as educational examples for the NEAR Intents ecosystem.