Integration notes

Confirmed Zama surfaces

A reviewer-facing map of the SDK exports, registry address, live proof, and adapter boundaries Custos relies on.

@zama-fhe/sdk 3.2.0

Chain

Sepolia

11155111

Registry

0x2f0750Bbb0A246059d80e94c454586a7F27a128e

SDK default

Live proof

9 pairs

July 6, 2026

SDK exports

Registry helpers used by Custos.

confirmed install

readTokenPairsContract

Reads all registered token/confidential-token pairs.

readTokenPairsLengthContract

Returns the registry pair count. Live Sepolia proof returned 9.

readTokenPairsSliceContract

Supports paginated registry reads for larger pair sets.

readTokenPairContract

Reads one registry pair by index.

readConfidentialTokenAddressContract

Maps an underlying ERC-20 to its confidential wrapper.

readTokenAddressContract

Maps a confidential token back to the underlying ERC-20.

readIsConfidentialTokenValidContract

Checks whether a confidential token is valid in the registry.

Live mode env

Enable live registry reads.

Demo mode remains the default review path, but live registry reads are available with these public environment values.

NEXT_PUBLIC_DEMO_MODE=false
NEXT_PUBLIC_CHAIN_ID=11155111
NEXT_PUBLIC_ZAMA_WRAPPERS_REGISTRY=0x2f0750Bbb0A246059d80e94c454586a7F27a128e
NEXT_PUBLIC_SEPOLIA_RPC_URL=https://ethereum-sepolia-rpc.publicnode.com

Adapter boundaries

Where the integration lives.

Registry adapter

src/lib/zama/registry.ts

Uses confirmed Zama SDK viem helpers and SDK default registry addresses.

Registry ABI

src/lib/zama/abis.ts

Contains confirmed registry read function names plus minimal wrapper write placeholders.

Unwrap state

src/lib/zama/unwrapStateMachine.ts

Persists async unwrap status locally and models pending KMS/finalization.

Decrypt adapter

src/lib/zama/decryption.ts

Keeps decrypted balance values in session state and isolates mock/live behavior.

TokenOps adapters

src/lib/tokenops/*

Documents confirmed TokenOps SDK modules for optional showcase flows.

Live registry proof

Pairs returned from Sepolia.

Open explorer

Underlying ERC-20	Confidential token	Status
0x9b5Cd13b8eFbB58Dc25A05CF411D8056058aDFfF	0x7c5BF43B851c1dff1a4feE8dB225b87f2C223639	valid
0xa7dA08FafDC9097Cc0E7D4f113A61e31d7e8e9b0	0x4E7B06D78965594eB5EF5414c357ca21E1554491	valid
0xff54739b16576FA5402F211D0b938469Ab9A5f3F	0x46208622DA27d91db4f0393733C8BA082ed83158	valid
0xFf021fB13cA64e5354c62c954b949a88cfDEb25E	0xaa5612FA27c927a0c7961f5AEFEE5ba3A0F9C891	valid
0x75355a85c6FB9df5f0C80FF54e8747EEe9a0BF57	0xf2D628d2598aF4eAF94CB76a437Ff86CA78FfbFB	valid
0x93c931278A2aad1916783F952f94276eA5111442	0xfCE5c7069c5525eF6c8C2b2E35A745bA20a2F7CC	valid
0x24377AE4AA0C45ecEe71225007f17c5D423dd940	0xe4FcF848739845BC81Dee1d5352cf3844F0a60C7	valid
0xf6Ef9ADB61A48E29E36bc873070A46A3D2667ff3	0x167DC962808B32CFFFc7e14B5018c0bE06A3A208	valid
0x6AB54988261AEC573a2CA13cF802d3B1114f864C	0x13F7d34A4f0102734F19E3Ff16e068Fe194B28c4	valid