Testnet Faucet

await sdk.login("your-client-id");

// A valid Cloudflare Turnstile token is required on every faucet mint. Obtain
// it from the Turnstile widget rendered in your app (its success callback).
const turnstileToken = await getTurnstileToken();

try {
  const response = await sdk.faucet.mint({ turnstileToken });

  // Resolves only when every token confirmed on-chain.
  for (const token of response.minted ?? []) {
    console.log(`Minted ${token.amount} ${token.symbol}`, token.txHash);
  }

  console.log("Remaining requests:", response.remainingRequests24h);
} catch (err) {
  // 429 quota exhausted, 502 mint failed/partial (error carries the
  // minted/failed breakdown), 503 faucet unavailable (safe to retry).
  console.warn("Faucet mint did not fully succeed", err);
}

curl -X POST "https://staging.apimonaco.xyz/api/v1/faucet/mint" \
  -H "Content-Type: application/json" \
  -H "X-Monaco-PublicKey: $MONACO_SESSION_PUBLIC_KEY" \
  -H "X-Monaco-Timestamp: $MONACO_TIMESTAMP" \
  -H "X-Monaco-Signature: $MONACO_SIGNATURE" \
  -d '{"turnstileToken": "0x..."}'

{
  "minted": [
    {
      "assetId": "123e4567-e89b-12d3-a456-426614174000",
      "symbol": "USDC",
      "amount": "10000.00",
      "txHash": "0x..."
    }
  ],
  "failed": [],
  "remainingRequests24h": 0
}

const info = await sdk.faucet.getInfo();

console.log(`${info.remainingRequests24h} of ${info.dailyLimit} requests left`);
if (info.remainingRequests24h === 0 && info.nextAvailableAt) {
  console.log(`Next request available at ${info.nextAvailableAt}`);
}

// Up to 5 most recent requests, newest first
for (const req of info.recentRequests) {
  console.log(req.requestedAt, req.minted.map((m) => `${m.amount} ${m.symbol}`));
}