Quickstart

Execute your first autonomous transaction in 5 minutes.

Prerequisites

• Node.js 18 or higher

• An x402-compatible wallet with private key

• Basic understanding of blockchain transactions

Install the SDK

npm install @molt402/sdk

Initialize the client

Create a new file agent.ts:

import { Molt402Client } from '@molt402/sdk'

const client = new Molt402Client({
  network: 'x402-testnet',
  wallet: {
    type: 'private_key',
    key: process.env.AGENT_PRIVATE_KEY
  }
})

Execute your first transaction

const result = await client.execute({
  instruction: "Transfer 10 TEST tokens to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  urgency: "standard"
})

console.log(`Transaction submitted: ${result.txHash}`)
console.log(`Estimated confirmation: ${result.estimatedConfirmation}`)

Monitor transaction status

const status = await client.getStatus(result.txHash)

console.log(`Status: ${status.state}`) // pending | included | confirmed | failed
console.log(`Block number: ${status.blockNumber}`)
console.log(`Gas used: ${status.gasUsed}`)

Handle completion

Wait for transaction finalization:

const finalStatus = await client.waitForConfirmation(result.txHash, {
  confirmations: 3,
  timeout: 120000 // 2 minutes
})

if (finalStatus.state === 'confirmed') {
  console.log('Transaction confirmed successfully')
} else {
  console.error('Transaction failed:', finalStatus.error)
}

Complete example

import { Molt402Client } from '@molt402/sdk'

async function main() {
  const client = new Molt402Client({
    network: 'x402-testnet',
    wallet: {
      type: 'private_key',
      key: process.env.AGENT_PRIVATE_KEY
    }
  })

  try {
    // Submit transaction
    const result = await client.execute({
      instruction: "Transfer 10 TEST tokens to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      urgency: "standard"
    })

    console.log(`Transaction submitted: ${result.txHash}`)

    // Wait for confirmation
    const status = await client.waitForConfirmation(result.txHash, {
      confirmations: 3
    })

    console.log(`Transaction confirmed in block ${status.blockNumber}`)
    console.log(`Gas used: ${status.gasUsed}`)

  } catch (error) {
    console.error('Transaction failed:', error.message)
  }
}

main()

Run the example

export AGENT_PRIVATE_KEY="your-private-key-here"
npx ts-node agent.ts

What's next?

Now that you've executed your first transaction, explore more advanced features:

• Configure approval policies: Set up autonomous transaction rules

• Optimize gas costs: Reduce transaction fees by 35%

• Handle batch operations: Execute multiple transactions efficiently

• Integrate with OpenClaw: Build autonomous agent workflows

Get testnet tokens

Need testnet tokens for testing? Visit the x402 faucet:

curl -X POST https://faucet.x402.network/api/claim \
  -H "Content-Type: application/json" \
  -d '{"address": "your-wallet-address"}'

Troubleshooting

"Insufficient funds" error

Check your wallet balance:

const balance = await client.getBalance('TEST')
console.log(`Balance: ${balance}`)

Transaction stuck in pending

Increase gas price for faster inclusion:

const result = await client.execute({
  instruction: "Transfer 10 TEST tokens to 0x742d35...",
  urgency: "fast" // or "instant" for highest priority
})

"Invalid instruction" error

The intent parser couldn't understand your instruction. Use structured format:

const result = await client.execute({
  action: "transfer",
  asset: "TEST",
  amount: "10",
  recipient: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
})

Support

Questions? We're here to help:

• Discord: discord.gg/molt402

• GitHub Issues: github.com/molt402-dev/sdk/issues

• Email: [email protected]