Documentation
Complete technical documentation for developers integrating with awa.cash privacy infrastructure
Overview
awa.cash is a non-custodial privacy and compliance infrastructure built on Solana. It enables private but lawful value transfers, relayer payments, and API-based integrations without shielding pools or mixers. All logic runs on-chain through audited Anchor smart contracts, with relayers and API clients interacting via public Solana accounts.
Architecture
AwaCore
Manages deposits, withdrawals, protocol fees, and on-chain accounting.
- •Handles fee calculation and burning
- •Distributes rewards to DAO treasury
- •Records all protocol metrics on-chain
AwaStaking
Manages $AWA staking for relayers, partners, and governance participants.
- •Enforces minimum collateral for relayers
- •Tracks stake weight for DAO voting
- •Allows stakers to claim revenue-share rewards
AwaDAO
A governance module allowing $AWA holders to vote on protocol parameters.
- •Controlled by the AwaCore program ID
- •Each proposal is an on-chain instruction
- •Executed via Solana CPI calls
$AWA Token Functions
Pay Protocol & Relayer Fees
Transaction fees paid in $AWA
Stake to Operate
Run relayers or nodes by staking collateral
Participate in DAO Voting
Governance rights for protocol decisions
Earn Staking Rewards
Receive fee distributions and rewards
Additional Use: Used for API access and integration credits
Relayer & Node System
Relayers broadcast anonymized withdrawal transactions on behalf of users or partners.
To operate a relayer:
- 1
Stake Required Collateral
Stake the required $AWA collateral in the AwaStaking program
- 2
Register Relayer Key
Register your relayer key via the on-chain instruction
register_relayer() - 3
Broadcast Transactions
Broadcast transactions through the awa.cash relay API at
/v1/relay/submit - 4
Earn Rewards
Earn a percentage of protocol fees in $AWA
Warning: Relayer stakes can be slashed for double-spending, spam, or non-compliance violations detected by the DAO.
Fee Model
| Action | Fee | Fee Destination |
|---|---|---|
| Transfer / Relayer Tx | 0.05% | 50% Burn / 50% DAO Treasury |
| API Access | Variable | DAO Treasury |
| Relayer Reward | 10–30% of tx fee | Paid in $AWA |
• All fees are processed on-chain by AwaCore
• Fee burn is done through the SPL burn() instruction, visible on Solscan and SolanaFM
Example On-Chain Flow
Deposit → Relayer → Withdraw
User deposits SOL or USDC via front-end → sent to AwaCore vault PDA
A small fee is converted to $AWA via Jupiter aggregator and burned
Relayer executes the withdrawal CPI call, receiving its $AWA reward
DAO treasury receives the remainder
All events are logged (DepositEvent, WithdrawEvent, FeeBurnEvent)
API Integration
Base URL:
https://api.awa.cash/v1/| Endpoint | Method | Description |
|---|---|---|
/tx/send | POST | Broadcast transaction via relayer |
/relayers/list | GET | List active relayers + fee rates |
/dao/proposals | GET | Fetch live governance proposals |
/staking/status | GET | Check stake balance & rewards |
Authentication
Developers obtain an API key by staking a minimum of 10,000 $AWA via the Staking contract and verifying ownership.
Governance (AwaDAO)
The DAO smart contract allows $AWA holders to vote on:
• Fee parameters
• Relayer minimum stake
• Treasury usage (audits, grants, buybacks)
• New supported tokens & networks
Voting Power: staked $AWA amount × time weight
Execution: Proposals are executed automatically through CPI calls on AwaCore
Example Code (Anchor Client)
import { Program, AnchorProvider, web3 } from "@coral-xyz/anchor";
import idl from "./awa_core.json";
const provider = AnchorProvider.env();
const program = new Program(
idl,
"AwACore11111111111111111111111111111111111",
provider
);
// Example: pay fee & record tx
await program.methods
.processTransaction(
new web3.PublicKey("RecipientPubkeyHere"),
new web3.BN(50000) // 0.05%
)
.accounts({
user: provider.wallet.publicKey,
vault: vaultPDA,
treasury: treasuryPDA,
tokenMint: AWA_MINT,
systemProgram: web3.SystemProgram.programId,
})
.rpc();Audits & Transparency
✓ Smart contracts audited by Neodyme Security (2025-02)
✓ ZK verifier stub removed in v1.1 (no shielded pool)
✓ Program logs & DAO votes verifiable via Solana Explorer
✓ Monthly transparency report published on GitHub