Cross-chain deposit infrastructure powered by Particle Network Universal Accounts. Accept deposits on multiple chains with automatic detection and bridge to your configured destination.

This monorepo contains:

• /sdk — The Universal Deposit SDK
• /deposit-demo — Next.js demo application

npm install @particle-network/universal-deposit

The React components (DepositWidget, DepositModal, RecoveryWidget, RecoveryModal) use Tailwind utility classes. The SDK ships a pre-built CSS file that you must import in your app:

/* In your global CSS file */
@import "@particle-network/universal-deposit/styles.css";

Or in a JS/TS entry point:

import '@particle-network/universal-deposit/styles.css';

Tailwind v4 users: If you prefer to avoid duplicate utility CSS, you can skip the import above and add an @source directive in your CSS instead:

@source "../node_modules/@particle-network/universal-deposit/dist/**/*.mjs";

import { DepositProvider, useDeposit, DepositModal, CHAIN } from '@particle-network/universal-deposit/react';

function App() {
  return (
    <DepositProvider config={{ destination: { chainId: CHAIN.ARBITRUM } }}>
      <YourApp />
    </DepositProvider>
  );
}

function DepositButton() {
  const { address } = useYourWallet();
  const { isReady } = useDeposit({ ownerAddress: address });
  const [open, setOpen] = useState(false);

  return (
    <>
      <button onClick={() => setOpen(true)} disabled={!isReady}>Deposit</button>
      <DepositModal isOpen={open} onClose={() => setOpen(false)} theme="dark" />
    </>
  );
}

import { useDeposit, DepositWidget } from '@particle-network/universal-deposit/react';

function Page() {
  const { address } = useYourWallet();
  const { isReady } = useDeposit({ ownerAddress: address });

  if (!isReady) return <Loading />;
  return <DepositWidget fullWidth theme="dark" />;
}

import { DepositClient, CHAIN } from '@particle-network/universal-deposit';

const client = new DepositClient({
  ownerAddress: '0x...',
  intermediaryAddress: '0x...',
  authCoreProvider: { signMessage: (msg) => provider.signMessage(msg) },
  destination: { chainId: CHAIN.ARBITRUM },
});

await client.initialize();
client.startWatching();

client.on('deposit:detected', (deposit) => {
  console.log(`${deposit.token} on chain ${deposit.chainId}: $${deposit.amountUSD}`);
});

client.on('deposit:complete', (result) => {
  console.log('Swept:', result.explorerUrl);
});

1. SDK creates a Universal Account (via an intermediary JWT wallet) that provides deposit addresses across multiple chains (EVM + Solana).
2. When funds arrive, the SDK detects them via balance polling and automatically bridges them to the configured destination.
3. Funds are consolidated on a single chain — no bridging required from the user.

• SDK Reference — Complete API reference
• Contributing Guide — Development workflow
• Runbook — Deployment & operations

This repo is open source. The instructions below are for running the demo app and contributing to the SDK locally.

• Node.js 18+ and npm
• Privy account and API keys (dashboard.privy.io)

1. Build the SDK from source:

   cd sdk && npm run build

2. Configure environment:

   cd deposit-demo
   cp .env.sample .env

   Fill in your NEXT_PUBLIC_PRIVY_APP_ID.

3. Run:

   npm install && npm run dev

4. Open http://localhost:3000

• Privy authentication (email or social)
• SDK auto-initialization (JWT fetch, Auth Core connection, Universal Account setup)
• Modal and inline display modes
• Real-time deposit detection and auto-sweep
• Activity history

cd sdk
npm run build             # Build ESM + CJS + types
npm run dev               # Watch mode
npm run typecheck         # Type checking
npm run test              # Unit tests
npm run test:integration  # Integration tests (real API)

Apache 2.0