01What
Changes your account's settings: turn account flags on or off, attach a domain name, or set fees and precision rules for tokens you issue.
02Why you'd use it
This is the control panel for your account. Common uses: requiring destination tags on incoming payments, enabling Default Ripple before issuing a token, or allowing clawback.
03How
- 1Pick at most one flag per transaction: choose a Set Flag to enable a behavior, or a Clear Flag to disable one.
- 2Optionally enter a Domain (like example.com) to publicly link your account to your website.
- 3Token issuers only: set Transfer Rate (1005000000 = a 0.5% fee when your token moves between holders) and Tick Size (price precision for your token on the DEX).
- 4Submit and confirm the result is tesSUCCESS.
Watch out
- asfDisableMaster locks out your master key. If you have no regular key or signer list set up, this can permanently lock the account — the ledger will refuse it, but treat this flag with extreme care.
- asfAllowTrustLineClawback only works if set before your token has any trust lines, and it can never be turned off.
- You can set one flag and clear one flag per transaction, not several at once.
- Even failed transactions with tec* results burn the fee.
For example
You are about to issue a loyalty-points token. Before anyone opens a trust line, you set asfDefaultRipple (so the token can move between holders) and asfAllowTrustLineClawback (so you can recover points if required by your terms).