> ## Documentation Index
> Fetch the complete documentation index at: https://zksync-sdk.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ZKsyncOS SDK

> Lightweight adapters for viem and ethers to build ZKsync L1↔L2 flows fast.

<div className="hero hero--bleed hero--split hero--ai">
  <div className="hero-inner">
    <div className="promo-left">
      <div className="pill-tag pill-tag--ring">
        <span className="pill-icon">⚡</span>
        Ready for the Atlas Upgrade
      </div>

      <h1 className="promo-title">
        <span className="zk-strong">Incorruptible</span>
        <span className="zk-strong">ZKsync power</span><br />
        in your favorite<br />libraries
      </h1>

      <p className="hero-subtitle">
        Extend <strong>viem</strong> and <strong>ethers</strong> with optimized L1↔L2 flows:
        deposits, withdrawals, and clean <code>status</code>/<code>wait</code> helpers—tuned for the
        Elastic Network and great DX.
      </p>

      <div className="hero-actions">
        <a className="hero-cta teal" href="./quickstart/index">Get started</a>

        <a className="hero-cta ghost" href="https://github.com/dutterbutter/zksync-sdk" target="_blank" rel="noreferrer">
          View on GitHub
        </a>
      </div>
    </div>

    <div className="promo-right">
      <div className="dev-card dev-card--gradient">
        <div className="dev-label">Install with bun</div>

        ```bash theme={"theme":{"light":"vitesse-light","dark":"tokyo-night"}}
        bun add @dutterbutter/zksync-sdk
        ```

        <div className="dev-footnote">
          Prefer npm or pnpm? Try <code>npm i</code> or <code>pnpm add.</code>
        </div>
      </div>
    </div>
  </div>
</div>

<section className="lp-container">
  <h2>Quickstart guides</h2>

  <Columns cols={3}>
    <Card title="Quickstart" icon="code" href="./quickstart">
      Install the `viem` or `ethers` adapter, connect clients, and run your first deposit.
    </Card>

    <Card title="Deposit (L1 → L2)" icon="money-bill-transfer" href="./guides/deposits">
      Send ETH or ERC-20 from Ethereum to ZKsync, then track L1 inclusion and L2 execution.
    </Card>

    <Card title="Withdraw (L2 → L1)" icon="money-check-dollar" href="./guides/withdrawals">
      Create the withdrawal on ZKsync, monitor execution, and finalize back on Ethereum.
    </Card>

    <Card title="Status & Wait helpers" icon="clock" href="./overview/status-vs-wait">
      Understand statuses vs waits and how to poll each phase of a flow.
    </Card>

    <Card title="Withdrawal Finalization" icon="circle-check" href="./overview/finalization">
      Understand the finalization process for withdrawals and how to ensure they are completed.
    </Card>

    <Card title="ZKsync RPC helpers" icon="terminal" href="./api-reference/core/rpc">
      Utilities like <code>getBridgehubAddress</code>, <code>getL2ToL1LogProof</code>.
    </Card>
  </Columns>
</section>

<section className="lp-container">
  <h2>Resources</h2>

  <Columns cols={3}>
    <Card title="SDK Reference" icon="book-open" href="./api-reference/introduction">
      Fully typed clients, methods, and errors for core and adapters.
    </Card>

    <Card title="Changelog" icon="calendar" href="./changelog">
      See what’s new, fixed, and changed across releases.
    </Card>

    <Card title="Support" icon="circle-info" href="https://github.com/zkSync-Community-Hub/zksync-developers/discussions/categories/sdks">
      Questions or issues? Reach out and we’ll help you.
    </Card>
  </Columns>
</section>