Skip to content

Gloam is live on Elysium. Private payments on Hyperliquid's new L2.

Open the app

Gloam SDK

Private payments, as a package

One import gives your app or agent private balances, private payments and proofs on Robinhood Chain, Tempo, Base, Ethereum and Elysium. Real proofs, checked on-chain, with no proving stack to build.

Install the SDK

Or start from a working app

TypeScriptNode and browserOpen source, MIT

Quickstart

Three calls to a private payment

Add money privately, pay from that balance, then hand the payment to the relay. You sign everything yourself. The SDK never holds a key.

  • Add money privatelybuildShieldBoundIntent
  • Pay privatelybuildPrivateSendIntent
  • Send through the relayrelayIntent
import {
	mainnetNetwork,
	buildShieldBoundIntent,
	buildPrivateSendIntent,
	relayIntent,
	artifactProver,
	circuitArtifactUrls,
	syncTree,
	TEMPO_USDCE,
} from "@gloamtrade/sdk";

// Tempo mainnet. GLOAM_NETWORKS.tempo is the testnet.
const net = mainnetNetwork("tempo");
if (!net) throw new Error("Tempo mainnet pool not published yet");
const target = { chainId: net.chainId, poolAddress: net.pool, asset: TEMPO_USDCE };

// 1. Add money privately. Sign deposit.exec from your own wallet.
// Keep deposit.note.secret: it is the only key to this balance.
const deposit = await buildShieldBoundIntent({
	...target,
	amountWei: parseUnits("10", 6),
	prover: artifactProver(circuitArtifactUrls("shield", net.chainId)),
});

// 2. Pay privately from that balance. The rest comes back as change.
const tree = await syncTree(publicClient, { pool: net.pool, fromBlock: net.deployBlock });
const send = await buildPrivateSendIntent({
	...target,
	secretHex: deposit.note.secret,
	amountInWei: parseUnits("10", 6),
	amountPayWei: parseUnits("4", 6),
	path: await tree.pathForCommitment(deposit.note.commitment),
	prove: artifactProver(circuitArtifactUrls("transfer", net.chainId)),
});

// 3. Send it through the relay. Your wallet never shows up.
const hash = await relayIntent(send);
pay.tsTypeScript

Everything a private app needs, in one import

The same core that runs the Gloam app. Pure TypeScript that works in the browser and on a server, with the prover passed in so you choose where proofs are made.

buildShieldBoundIntent

Private balances

Move stablecoins into a balance only the holder can see or spend.

buildPrivateSendIntent

Private payments

Pay inside the vault to a Gloam address. No public transfer, no visible amount.

buildUnshieldIntent

Cash out

Move money back to any public wallet, whenever the holder wants it public.

relayIntent

Relay

Sends and cash outs go out through the relay, so the sender's wallet never shows up. It can submit or refuse, never redirect.

buildComplianceDisclosure

Prove

Share one fact with one party, a payment with its issuer or a balance with an auditor, and nothing else.

gloamNetworks

One core on each chain

The same circuits and the same calls on Robinhood Chain, Tempo, Base, Ethereum and Elysium, mainnet and testnet. Pick a network, keep the code.

For agents

Agents pay without showing their treasury

Agents pay for tools and data over HTTP 402. With Gloam the agent settles each payment privately from its own balance, then shows the payment as proof. Only the payer and the payee learn the amount, and no operator ever holds the agent's key or money.

  • Add money to the agent's private balancegloam_execute_shield
  • Fetch a URL and pay its 402 privately, in one callgloam_fetch_paid
  • Price a tool or a dataset with a 402gloam_payment_requirements
  • Check a payment and sweep it before servinggloam_verify_payment
  • The agent's balances, as handles, never secretsgloam_list_notes
  • What it spent today and what is leftgloam_get_spending_report

Research agent

Pays per call, privately

x402
  • GET

    mcp://tool/summarize

    Agent asks

  • 402

    Payment required

    Tool answers

  • Paid privately

    From the agent's own balance

    0.25 USD
  • 200

    Summary delivered

    Payment checked first

The explorer showsExplorerPrivate transfer
Connect any MCP clientmcp.json
{
	"mcpServers": {
		"gloam": {
			"command": "npx",
			"args": ["-y", "@gloamtrade/mcp"]
		}
	}
}

create-gloam-app

One command to a working app

Scaffolds a Next.js app already wired to the SDK, with private balances and payments working on testnet from the first run.

Honest about where it is

Live on mainnet

Live on Robinhood Chain, Tempo, Base, Ethereum and Elysium mainnet, under deposit limits. The testnets stay open.

Keys

Mainnet, Base Sepolia and Ethereum Sepolia proofs use the final keys from the 13-contributor ceremony; the Robinhood Chain and Tempo testnets use development keys. Reviewed internally before launch; Kann Audits has since reviewed the vault contracts and found no Critical, High or Medium issues.

Nothing faked

If a path cannot be private yet, the SDK returns a plan instead of a pretend result.