AI integration

Documentation Index

Fetch the complete documentation index at: https://docs.cloak.ag/llms.txt

Use this file to discover all available pages before exploring further.

Use this page to point coding agents at the right Cloak docs before they write code.

​

Canonical AI files

​

Recommended read order

​

TypeScript integrations

1. /llms.txt
2. /llms-full.txt
3. /sdk/llms.txt
4. /sdk/quickstart
5. /sdk/utxo-transactions

​

Rust integrations

1. /llms.txt
2. /llms-full.txt
3. /sdk/rust/llms.txt
4. /sdk/rust/quickstart
5. /sdk/rust/core-concepts

​

One-shot prompt: simple SOL send flow (TypeScript)

Use this as your first message in Claude Code, Cursor, or Windsurf when the host app is TypeScript.

Copy TypeScript one-shot prompt

Implement a minimal Cloak integration for a simple SOL send flow using @cloak.dev/sdk.Read these docs first and follow them exactly:

• /llms.txt
• /llms-full.txt
• /sdk/llms.txt
• /sdk/quickstart
• /sdk/utxo-transactions
• /sdk/wallet-integration

Build requirements:

1. Use the UTXO API (not legacy note APIs) and keep transaction amounts as bigint.
2. Implement deposit then full withdraw (send) flow:
   • deposit with transact(...)
   • send with fullWithdraw(...)
3. Include one integration path using keypair bytes and one using wallet-adapter where relevant.
4. Add progress and error states suitable for production UX.
5. Never log secrets (private keys, viewing keys (nk), raw note payloads, seed material). Transaction signatures are public and may be logged for support/debugging.
6. Rely on SDK default stale-root handling for standard flows; do not add custom retry loops unless explicitly requested.
7. Use SDK defaults for program, relay, and circuits. Do not ask end users to configure these.
8. For script-only tasks, default to keypair path + lamports CLI (<recipientPubkey> <lamports>).
9. For script-only tasks, parse recipient/amount from CLI args (not env) and exit explicitly (process.exit(0|1)).

Return format:

• capability matrix (used / not used) for: note API, UTXO API, scanner/compliance, viewing keys/metadata encryption, relay/proof/Merkle helpers, utility modules
• file-by-file patches
• commands run
• verification summary

​

One-shot prompt: simple SOL send flow (Rust)

Use this as your first message when the host app is Rust.

Copy Rust one-shot prompt

Implement a minimal Cloak integration for a simple SOL send flow using the cloak-sdk Rust crate.Read these docs first and follow them exactly:

• /llms.txt
• /llms-full.txt
• /sdk/rust/llms.txt
• /sdk/rust/quickstart
• /sdk/rust/api-reference
• /sdk/rust/error-handling

Build requirements:

1. Use cloak_sdk::core::transact::transact(opts) as the single entrypoint. Every flow is a TransactOptions shape.
2. Keep amounts as u64 / i64. No float parsing.
3. Implement deposit → withdraw as two sequential transact() calls. Thread cached_merkle_tree + address_lookup_table_accounts from the first result into the second.
4. Load the signer from the KEYPAIR_PATH Solana JSON keypair file. Never accept raw secret bytes via env.
5. Populate opts.rpc with SolanaRpc::new(SOLANA_RPC_URL), opts.payer with Arc::new(keypair), and opts.relay_url with https://api.cloak.ag.
6. Save the UtxoKeypair for every output you create — it’s required to spend the note later. Persist it to disk.
7. Never log private keys, viewing keys (nk), UTXO private keys, blindings, or note payloads. Transaction signatures are public and may be logged.
8. Rely on SDK default retry loops (RootNotFound, BlockhashExpired, StaleProofState); do not add custom retry wrappers.
9. Use SDK defaults for program, relay, and circuits (CLOAK_PROGRAM_ID, NATIVE_SOL_MINT, CIRCUITS_BASE_URL from cloak_sdk::constants). Do not expose as user config.
10. For one-file binaries, parse recipient/amount from std::env::args() and exit explicitly with std::process::exit(0|1) (or return Result<()> from main).

Return format:

• capability matrix (used / not used) for: transact() entrypoint, UTXO primitives, risk oracle, ALT auto-create, VK registration, swap, scanner (stub — mention if you’d need it)
• file-by-file patches
• commands run (cargo build, cargo run -- ...)
• verification summary

​

Success checklist

Shared across both SDKs:

• UTXO flow is the primary execution path.
• Sign-of-external-amount semantics are correct (positive = deposit, negative = withdraw/swap, zero = transfer).
• No secret leakage in logs or telemetry.
• Docs references are included in the implementation notes.
• No custom retry wrappers (the SDK handles stale-root + blockhash + transient transport).

TypeScript-specific:

• All tx amount math stays in bigint.
• No raw private key env var (SENDER_PRIVATE_KEY) and no float amount parsing (AMOUNT_SOL, parseFloat).
• No RECIPIENT_ADDRESS/SEND_LAMPORTS env contract for one-file scripts; use CLI args.
• Script exits explicitly on success/failure (process.exit(0|1)).

Rust-specific:

• Amounts stay as u64 / i64. No float math.
• Signer loaded from KEYPAIR_PATH (Solana JSON keypair file).
• UtxoKeypair for each output is persisted (required to spend the note later).
• cached_merkle_tree + address_lookup_table_accounts threaded across sequential transacts.
• main returns Result<()> or exits via std::process::exit(0|1).

​

Ultra-short prompt fallback

When the user prompt is short/vague (including non-English prompts), detect the likely host language and default to the matching shape.

​

TypeScript default

• one file only
• keypair-based send path
• CLI: npx tsx send-sol-private.ts <recipientPubkey> <lamports>
• recipient/amount read from process.argv
• env vars: SOLANA_RPC_URL, KEYPAIR_PATH
• no user-facing relay/circuits/program config
• explicit process.exit(0) on success and process.exit(1) on failure

​

Rust default

• one cargo run-able binary
• CLI: cargo run -- <recipientPubkey> <lamports>
• recipient/amount parsed from std::env::args()
• env vars: SOLANA_RPC_URL, KEYPAIR_PATH
• no user-facing relay/circuits/program config
• main returns anyhow::Result<()> or exits via std::process::exit(0|1)

Example short prompts that should still produce valid output:

• TypeScript: faca um script com esse sdk para mandar sol privado https://docs.cloak.ag
• Rust: a rust cli that privately sends sol

​

Related docs

• LLM Index
• LLM Full Export
• TypeScript SDK LLM Reference
• Rust SDK LLM Reference
• TypeScript Quickstart
• Rust Quickstart
• UTXO Transactions (TS)