@monad-agent-kit/plugin-token

Token operations plugin for Monad Agent Kit — transfer, balance, approve, and allowance for native MON and ERC-20 tokens.

Installation

``bash
bun add @monad-agent-kit/core @monad-agent-kit/plugin-token
`

Usage

`typescript
import { MonadAgentKit } from "@monad-agent-kit/core"
import { tokenPlugin } from "@monad-agent-kit/plugin-token"

const agent = new MonadAgentKit({ privateKey: "0x..." })
await agent.use(tokenPlugin)
`

Actions

$3

Send native MON or ERC-20 tokens.

`typescript
// Send native MON
await agent.execute("transfer", {
to: "0x...",
amount: "1.5",
})

// Send ERC-20 token
await agent.execute("transfer", {
to: "0x...",
amount: "100",
token: "0x...", // ERC-20 contract address
})
`

$3

Execute multiple transfers in a single call. Supports mixed native MON and ERC-20 transfers.

`typescript
await agent.execute("batchTransfer", {
transfers: [
{ to: "0xAlice", amount: "1.0" }, // MON
{ to: "0xBob", amount: "50", token: "0xUSDC" }, // ERC-20
{ to: "0xCharlie", amount: "2.0" }, // MON
],
})
`

$3

Check token balance for any address.

`typescript
// Native MON balance (own wallet)
await agent.execute("getBalance", {})

// ERC-20 balance for another address
await agent.execute("getBalance", {
address: "0x...",
token: "0x...",
})
`

$3

Set ERC-20 spending allowance.

`typescript
await agent.execute("approve", {
token: "0x...",
spender: "0x...",
amount: "1000",
})
`

$3

Check current ERC-20 allowance.

`typescript
await agent.execute("getAllowance", {
token: "0x...",
spender: "0x...",
owner: "0x...", // optional, defaults to agent wallet
})
`

Exports

`typescript
import {
tokenPlugin, // Plugin object
transferAction, // Individual actions
batchTransferAction,
balanceAction,
approveAction,
allowanceAction,
erc20Abi, // Standard ERC-20 ABI
} from "@monad-agent-kit/plugin-token"
``

License

MIT