Skip to main content

Atto Wallet Server API (v1.0.0)

Download OpenAPI specification:Download

The Atto Wallet Server provides a simple, self-hostable interface to manage accounts, send and receive funds, and track balances within the Atto network. It is designed for use by applications, abstracting away the complexity of directly interacting with the node.

Accounts

Manage accounts within a wallet. This controller allows clients to create new accounts, enable or disable them, send transactions, and change a representative. Accounts are scoped to wallets and represent individual identities on the Atto network. This interface is designed for applications interacting with locally managed accounts.

Get accounts for given wallet

path Parameters
walletName
required
string

Responses

Create an account

path Parameters
walletName
required
string

Responses

Send to target address

path Parameters
address
required
string
Request Body schema: application/json
required
string

Responses

Request samples

Content type
application/json
"string"

Change representative

path Parameters
address
required
string
Request Body schema: application/json
required
Schema not provided

Responses

Enable an account

path Parameters
address
required
string

Responses

Disable an account

path Parameters
address
required
string

Responses

Get account entries

Request Body schema: application/json
Schema not provided

Responses

Disable an account

path Parameters
address
required
string

Responses

Disable an account

path Parameters
address
required
string

Responses

Wallets

Manage wallets in the self-hosted Atto Wallet Server. This controller allows you to create new wallets, import existing ones using mnemonics, lock and unlock wallets by managing their in-memory decryption keys, and list or retrieve wallet information. Designed for applications that require secure and programmatic control over local wallets.

Get wallet metadata

Retrieves metadata for the wallet identified by name.

path Parameters
name
required
string

Responses

Import existing wallet

Imports a wallet from its 24‑word mnemonic. You may supply your own Cha Cha 20 encryption key; if omitted, the server generates one. Losing either the mnemonic or key means permanent loss of access.

path Parameters
name
required
string
Request Body schema: application/json
required
string

Responses

Request samples

Content type
application/json
"string"

Create a wallet

Generates a brand‑new wallet with a fresh mnemonic and encryption key, both encrypted at rest. Losing either will lock the wallet forever.

path Parameters
name
required
string

Responses

Unlock wallet

Loads the provided encryptionKey into memory and stores it securely by encrypting it at rest using the CHA_CHA20_KEY_ENCRYPTION_KEY.

path Parameters
name
required
string
Request Body schema: application/json
required
Schema not provided

Responses

Lock wallet

Purges the decryption key for the wallet, preventing signing operations until it is unlocked again.

path Parameters
name
required
string

Responses

List all wallets

Lists every wallet stored on the server together with its current lock state.

Responses

no-op-callback-controller

noOpCallback

Responses

Footer background
Ready to Experience Atto?Enjoy instant, feeless, and eco-friendly transactions with just a tap.
Copyright © 2025 Atto B.V.
X.comRedditLinkedinGithubDiscord