💼 External Wallet Management

The AUDD Mint operates as a non-custodial platform. This means that when you mint AUDD, the tokens are sent directly to the wallet you specify - there’s no holding account or custody layer in between. Conversely, when burning AUDD, our system needs to identify that the AUDD sent to us came from an authorised source. To enable this, you’ll first need to register your wallet in the Mint system so it can be used as a valid destination.

🧩 Wallet Types

You can register two types of external wallets, depending on how your organisation handles funds:

Distributor Wallets: Owned and controlled by your company; often used as a treasury or operational wallet for managing your own AUDD balance.
Customer Wallets: belongs to an end user of your platform. If your service is non-custodial, this lets you define wallets as customer-owned so AUDD can be minted directly to them without passing through your own accounts.

📝 Creating an External Wallet

Add External Wallet

Open Recipe

To add a new external wallet, use the POST /wallets/external endpoint. This call registers the wallet within the AUDD Mint system so it can be selected when submitting mint requests.

Your request body should include the following fields:

Field	Type	Required	Description
`publicKey`	string	✅	The public key (wallet address) of the external wallet to add. Must be valid on the chosen blockchain.
`companyId`	string	✅	The ID of the distributor company registering the wallet.
`nickname`	string	✅	A friendly label to identify the wallet in Mint.
`type`	string	✅	Defines who manages the wallet. Use `DISTRIBUTOR` for company-managed wallets or `CUSTOMER` for end-user wallets.
`network`	string	✅	The blockchain network where the wallet exists (e.g., `STELLAR_TESTNET`, `ETHEREUM_GOERLI`, `SOLANA_DEVNET`).

🚧
Wallet Activation:
For blockchains like Stellar or XRP Ledger, wallet owners are required to establish a Trustline to AUDD first, before any tokens can be received. For more information, visit our guide on Trustlines.

📤 Example Request

{
    "publicKey": "wallet public key",
    "companyId": "company id",
    "nickname": "example",
    "type": "DISTRIBUTOR",
    "network": "STELLAR_TESTNET"
}

📥 Example Response

{
    "id": "wallet id",
    "publicKey": "wallet public key",
    "network": "STELLAR_TESTNET",
    "company": {
        "id": "company id",
        "name": "company name",
        "types": null
    },
    "nickname": "example",
    "type": "DISTRIBUTOR",
    "custody": "EXTERNAL",
    "dateCreated": "timestamp",
    "createdBy": {
        "id": "user id",
        "firstName": "first name",
        "lastName": "last name",
        "email": null,
        "phone": null
    },
    "totalPayment": 0,
    "status": "ACTIVE",
    "thresholds": {
        "low": 0,
        "medium": 0,
        "high": 0
    },
    "transactionId": null,
    "balances": [],
    "signers": [],
    "homeUrl": null,
    "link": "wallet on chain link",
    "masterKeyWeight": 1,
    "quorum": null,
    "address": null,
    "reference": "reference",
    "whitelist": [],
    "clawbackEnabled": false,
    "authorizationRevocable": false,
    "authorizationRequired": false,
    "authorizationImmutable": false,
    "defaultRipple": false
}

❗️
Save your Wallet ID
The id returned in the response is required when submitting mint or burn requests. Be sure to store it securely so it can be referenced later.