Skip to content

Actions

The agent wallet supports 14 action providers with 25+ individual actions.

Wallet Management

Action	Description
`get_wallet_balance`	Get total wallet balance (shared across all escrows)
`get_escrow_info`	Get escrow app ID, name, and lock status
`get_allowance_status`	Check remaining spending allowance for an asset
`get_installed_plugins`	List all plugins bound to this escrow
`list_escrows`	List all escrows on the wallet

Payments & Assets

Action	Description
`send_payment`	Send ALGO or ASA payments from the escrow
`opt_in_asset`	Opt the escrow into receiving a new asset
`mint_asset`	Create (mint) a new ASA with custom parameters

DeFi

Action	Description
`stake_tokens`	Stake tokens to earn rewards
`withdraw_stake`	Withdraw staked tokens
`create_swap`	Create a token swap offer (HyperSwap)
`accept_swap`	Accept an existing swap
`cancel_swap`	Cancel your swap offer
`subscribe`	Set up a recurring subscription payment
`trigger_payment`	Trigger a subscription payment

NFT Marketplace

Action	Description
`list_nft`	List an NFT for sale on the marketplace
`purchase_nft`	Purchase a listed NFT
`delist_nft`	Remove an NFT listing
`place_bid`	Place a bid in an auction
`enter_raffle`	Enter a raffle

Action	Description
`create_proposal`	Create a DAO proposal
`vote_proposal`	Vote on a DAO proposal
`vote_poll`	Vote on a community poll
`create_post`	Create a post on Akita social
`follow_user`	Follow a user on Akita social

Rewards

Action	Description
`claim_rewards`	Claim staking and participation rewards

Action Providers

Each category is implemented as an ActionProvider class:

Provider	Actions
`WalletInfoActionProvider`	`get_wallet_balance`, `get_escrow_info`, `get_allowance_status`, `get_installed_plugins`, `list_escrows`
`PayActionProvider`	`send_payment`
`OptInActionProvider`	`opt_in_asset`
`MintActionProvider`	`mint_asset`
`StakingActionProvider`	`stake_tokens`, `withdraw_stake`
`SwapActionProvider`	`create_swap`, `accept_swap`, `cancel_swap`
`SubscriptionsActionProvider`	`subscribe`, `trigger_payment`
`MarketplaceActionProvider`	`list_nft`, `purchase_nft`, `delist_nft`
`AuctionActionProvider`	`place_bid`
`RaffleActionProvider`	`enter_raffle`
`DaoActionProvider`	`create_proposal`, `vote_proposal`
`PollActionProvider`	`vote_poll`
`SocialActionProvider`	`create_post`, `follow_user`
`RewardsActionProvider`	`claim_rewards`

Listing Actions

const actions = agentKit.getActions()

for (const action of actions) {
  console.log(`${action.name}: ${action.description}`)
  console.log('Input schema:', JSON.stringify(action.inputSchema))
}

Executing Actions

const result = await agentKit.executeAction('send_payment', {
  receiver: 'RECIPIENT_ADDRESS',
  amount: 1_000_000,  // 1 ALGO in microAlgos
})

// Result is a JSON string with { summary, txIds }
const parsed = JSON.parse(result)
console.log(parsed.summary)
console.log(parsed.txIds)

CLI Execution

# List available actions
akita-agent-wallet actions

# Execute an action with JSON arguments
akita-agent-wallet exec send_payment '{"receiver":"ADDR...","amount":1000000}'