Every Aqueduct vault is a Solana Action, so a post, a QR code or a chat message can carry a working deposit. Drop a themable deposit card into any site with one script tag, or build your own flow with the React hooks and public API.
Paste any of these links into a Blink-aware client (Phantom, Backpack, Dialect, X with the Blinks extension) and it unfurls into a live card that builds the transaction for the reader's wallet. The faucet chains straight into a deposit once its transaction lands. The cards below are rendered from the live endpoints; withdrawals work the same way.
Blue-chip lending only. Built to never surprise you. Routed across 5 vetted venues by a risk-aware keeper, $250,241 deposited. 5% performance fee on yield only; no deposit or withdrawal fees. Withdraw any time. Runs on Solana devnet with test USDC.
Adds credit, delta-neutral and fixed-rate yield. Higher return, higher risk. Routed across 6 vetted venues by a risk-aware keeper, $100,173 deposited. 10% performance fee on yield only; no deposit or withdrawal fees. Withdraw any time. Runs on Solana devnet with test USDC.
Get devnet test USDC to try Aqueduct, the Solana stablecoin yield router. Up to 10,000 per transaction; after it lands you can deposit straight from here. Runs on Solana devnet with test USDC.
| Action | Share link | |
|---|---|---|
| Deposit into Bedrock | solana-action:https://aqueduct.justus.sh/api/actions/bedrock/deposit | dial.to |
| Deposit into Rapids | solana-action:https://aqueduct.justus.sh/api/actions/rapids/deposit | dial.to |
| Withdraw from Bedrock | solana-action:https://aqueduct.justus.sh/api/actions/bedrock/withdraw | dial.to |
| Withdraw from Rapids | solana-action:https://aqueduct.justus.sh/api/actions/rapids/withdraw | dial.to |
| Mint test USDC | solana-action:https://aqueduct.justus.sh/api/actions/faucet | dial.to |
curl https://aqueduct.justus.sh/api/actions/bedrock/deposit
curl -X POST "https://aqueduct.justus.sh/api/actions/bedrock/deposit?amount=100" \
-H "Content-Type: application/json" \
-d '{"account":"<your devnet wallet>"}'
# -> { "type": "transaction", "transaction": "<base64, unsigned>", "message": "...", "links": { "next": ... } }https://aqueduct.justus.sh/actions.json maps /blink/{tier}/{deposit|withdraw} and /blink/faucet onto the action API, so the friendly share pages unfurl too. Every response carries open CORS, X-Action-Version: 2.4 and the devnet X-Blockchain-Ids.
POSTs are checked before a wallet ever sees them: amount, wallet USDC and SOL, the vault's cap and your position, then a read-only simulation, so problems come back as plain sentences such as “You have 40 USDC” instead of a failed transaction.
Withdrawal amounts are in USDC and converted to shares at the live share price; amount=all redeems the whole position without leaving dust.
One tag gives any website a live Aqueduct deposit: current APY, wallet connect, deposit, withdraw and an inline test USDC faucet. It sizes itself, follows your theme and reports confirmed transactions to your page.
<div data-aqueduct-widget data-tier="bedrock"></div>
<script async src="https://aqueduct.justus.sh/embed.js"></script>| Attribute | Values | Default |
|---|---|---|
data-tier | bedrock, rapids | bedrock |
data-theme | light, dark | light |
data-accent | Hex colour for the main button | Aqueduct ink |
data-radius | Corner radius in px, 0 to 32 | 20 |
data-mode | deposit, withdraw | deposit |
data-amount | Prefilled USDC amount | empty |
data-width | Max width of the frame | 420px |
document.addEventListener("aqueduct:transaction", (e) => {
// { kind: "deposit" | "withdraw", tier, amount, signature }
analytics.track("aqueduct_deposit", e.detail);
});<iframe
src="https://aqueduct.justus.sh/embed/rapids?theme=dark&accent=7c3aed&radius=14"
title="Aqueduct deposit" style="width:100%;max-width:420px;height:480px;border:0"></iframe>Live preview. Wallets that inject into frames (Phantom, Solflare, Backpack) connect inside the card; when none is found it offers the Blink and the full app instead.
Hooks and headless components over the public API: no Anchor, no IDL and no RPC keys in your bundle. Transactions are built by the Actions endpoint and signed by whichever wallet you already use.
import { AqueductProvider, useVault, useDeposit } from "@aqueduct/react";
import { walletAdapterBinding } from "@aqueduct/react/solana";
import { useConnection, useWallet } from "@solana/wallet-adapter-react";
export function App() {
return (
<AqueductProvider baseUrl="https://aqueduct.justus.sh">
<EarnCard />
</AqueductProvider>
);
}
function EarnCard() {
const { vault } = useVault("bedrock");
const wallet = walletAdapterBinding(useWallet(), useConnection().connection);
const deposit = useDeposit("bedrock", wallet);
return (
<button disabled={deposit.busy} onClick={() => deposit.run(100)}>
{deposit.busy ? deposit.stage : `Earn ${vault?.apy.toFixed(2)}% on 100 USDC`}
</button>
);
}import { AmountFormController, Apy } from "@aqueduct/react";
<p>Bedrock pays <Apy tier="bedrock" /> right now.</p>
<AmountFormController kind="deposit" tier="bedrock" wallet={wallet}>
{(f) => (
<form onSubmit={(e) => (e.preventDefault(), f.submit())}>
<input value={f.value} onChange={(e) => f.setValue(e.target.value)} />
<button type="button" onClick={f.setMax}>Max</button>
{f.error && <small>{f.error}</small>}
<button disabled={!f.canSubmit}>{f.action.busy ? f.action.stage : "Deposit"}</button>
</form>
)}
</AmountFormController>| Export | What it gives you |
|---|---|
useVaults() / useVault(tier) | Live net APY, TVL, share price and allocation; polls every 30 s, SSR-seedable |
usePosition(owner, tier) | The wallet's position value and shares, plus its USDC balance |
useDecisions({ tier, limit }) | The keeper's rebalance decisions with sentinel verdicts |
useDeposit / useWithdraw / useFaucet | build, sign, confirm, refresh: stage, message, signature and readable errors |
useAmountForm(kind, tier, wallet) | Input state, Max, validation against balance, position and vault cap |
<Apy>, <VaultData>, <AmountFormController>, <Decisions> | Headless render-prop components |
@aqueduct/react/solana | walletAdapterBinding and keypairBinding for @solana/web3.js wallets |
@aqueduct/react/core | The framework-free client, cache and transaction runner |
Everything above runs on public, CORS-open endpoints. Reads are cached for a few seconds at the edge; nothing requires a key.
| Endpoint | Returns |
|---|---|
GET /api/v1/vaults | Both vaults: APY, gross APY, TVL, idle, share price, cap, fees, strategies |
GET /api/v1/positions/{owner} | A wallet's USDC balance and its position in each vault |
GET|POST /api/actions/{tier}/{deposit|withdraw} | Solana Action metadata, or an unsigned transaction for { account } |
GET|POST /api/actions/faucet | Mint up to 10,000 devnet test USDC, chained into a deposit |
GET /api/actions/icon/{tier|faucet} | 800 x 800 PNG with the live APY, used as the Blink image |
GET /actions.json | Blink URL mapping for this domain |
GET /embed/{tier} | The deposit card, for iframes |
GET keeper /rates, /decisions, /targets, /fees | Live venue rates and the rebalancer's decisions and targets |
The site sends a strict content security policy with frame-ancestors 'none'. The card only works if /embed/** is excluded from it and served with frame-ancestors * (and no X-Frame-Options) instead. Actions and the API set their own CORS headers in their route handlers, so they work under any page policy.
async headers() {
return [
// Everything except /embed/** keeps the strict policy.
{ source: "/:path((?!embed/).*)", headers: securityHeaders },
// The deposit card is meant to be framed by any site.
{ source: "/embed/:path*", headers: embedHeaders },
];
}