The @oaknetwork/contracts-sdk package is a TypeScript SDK for interacting with Oak Network smart contracts. It provides a type-safe client with full read/write access to all Oak protocol contracts, built on top of viem.
Testnet firstStart by pointing the SDK at Celo Sepolia testnet (CHAIN_IDS.CELO_TESTNET_SEPOLIA) to experiment without risking real funds.
Deployed addressesYou need deployed contract addresses to use this SDK — including factory addresses (for example CampaignInfoFactory, TreasuryFactory) and any protocol contracts you call through the client. The SDK interacts with Oak Network smart contracts that must already be deployed on-chain. To get your contract addresses and sandbox environment access, contact our team at support@oaknetwork.org.
Highlights
Flexible signers — simple keyed client, read-only RPC client, per-entity or per-call signer overrides, or full viem PublicClient / WalletClient setup including Privy embedded wallets (see Client Configuration)
Entity factories for every on-chain contract: oak.globalParams(address), oak.campaignInfo(address), etc.
Typed reads, writes, and simulations — every method is fully typed with TypeScript
Typed error decoding — parseContractError() turns raw revert data into SDK errors with recovery hints
Pure utility exports — hashing, encoding, time helpers, and chain resolution with zero client dependency
Tree-shakeable entry points — import only what you need: @oaknetwork/contracts-sdk/utils, @oaknetwork/contracts-sdk/client, etc.