Developer documentation

WallCard SDK

Partner integration SDK that exposes an EIP-1193 wallet provider for existing EVM and Solana dApps. Popup card approval instead of a browser extension.

WallCard SDK is an integration layer similar in role to Privy or MetaMask SDK. Your dApp imports a provider object, calls standard wallet RPC methods, and WallCard opens hosted wallet UI (popup or iframe) for card credentials and transaction approval.

Install

npm install @wallcard/sdk-core. Optional React helpers: npm install @wallcard/sdk-react. Production wallet and API URLs are embedded in the SDK. SessionConnect still requires your dApp origin to be allowlisted by NodeRails.

What it is

  • An EIP-1193 compatible provider via createNoderailsCardProvider().
  • EVM methods your wagmi, viem, or ethers app already expects (eth_requestAccounts, personal_sign, eth_sendTransaction, and more).
  • Solana wallet-style RPC methods on the same provider (solana_signTransaction, solana_signAndSendTransaction, and more).
  • Hosted WallCard wallet flows instead of injecting window.ethereum from an extension.

What it is not

  • Not ethers.js or viem. Use those libraries on top of the WallCard provider.
  • Not the WallCard mobile app SDK. Integrator docs do not use Expo or mobile build env vars.
  • Not a key export SDK. Private keys never enter your dApp JavaScript context.

Packages

PackageRole
@wallcard/sdk-corecreateNoderailsCardProvider(), SessionConnect helpers, EIP-1193 request()
@wallcard/sdk-reactOptional React context wrapper around the core provider

Live playground

See /examples for working SessionConnect and signing recipes you can run against your integration environment.