# Welcome to Candide

A TypeScript toolkit for building Ethereum smart wallets: gas sponsorship, passkeys, batch transactions, and account recovery, all on top of Safe contracts.

## Quick Start[​](#quick-start "Direct link to Quick Start")

```
npm install abstractionkit
```

```
import { SafeAccountV0_3_0 as SafeAccount } from "abstractionkit";

const account = SafeAccount.initializeNewAccount([ownerPublicKey]);
console.log(account.accountAddress); // 0x… deterministic smart wallet address
```

<!-- -->

<!-- -->

[Send your First Gasless Transaction](https://docs.candide.dev/wallet/guides/getting-started.md)

[Create a smart account and submit your first gasless UserOperation with batched transactions](https://docs.candide.dev/wallet/guides/getting-started.md)

[Pay Gas in ERC-20](https://docs.candide.dev/wallet/guides/pay-gas-in-erc20.md)

[Let users pay transaction fees in USDC, DAI, or any ERC-20 token](https://docs.candide.dev/wallet/guides/pay-gas-in-erc20.md)

[EIP-7702 Account Upgrades](https://docs.candide.dev/wallet/guides/getting-started-eip-7702.md)

[Upgrade existing EOAs to smart accounts with EIP-7702 delegation](https://docs.candide.dev/wallet/guides/getting-started-eip-7702.md)

**Using AI to build faster**:

Every page has a **Copy Page** button in the toolbar. Paste it directly into Claude or ChatGPT with a pre-filled prompt. For agents and IDE integrations like Claude Code or Cursor, point them to [`/llms.txt`](https://docs.candide.dev/llms.txt) for a full index of the docs.

## Why Smart Accounts?[​](#why-smart-accounts "Direct link to Why Smart Accounts?")

Smart accounts eliminate the biggest UX barriers in Web3:

* **No gas tokens**: Users pay fees in any ERC-20 or have them sponsored entirely
* **Modern onboarding**: Login with passkeys, email, or social accounts. No seed phrases
* **Built-in security**: Account recovery, multisig support, and spending limits
* **Batch transactions**: Execute multiple operations atomically in a single transaction

*Smart accounts are programmable contracts, unlocking capabilities impossible with traditional EOAs.*

## Core Features[​](#core-features "Direct link to Core Features")

### Gas Abstraction[​](#gas-abstraction "Direct link to Gas Abstraction")

* Gasless transactions: [Sponsor user fees](https://docs.candide.dev/wallet/guides/send-gasless-tx.md) with flexible rules and policies
* ERC-20 gas payments: Let users [pay gas in any token](https://docs.candide.dev/wallet/guides/pay-gas-in-erc20.md) (USDC, DAI, etc.)

### Modern Authentication[​](#modern-authentication "Direct link to Modern Authentication")

* Passkey integration: [Onchain WebAuthn](https://docs.candide.dev/wallet/plugins/passkeys.md) support for biometric login
* Social login: [Email and OAuth](https://docs.candide.dev/wallet/guides/authentication/.md#social--email) integration

### Advanced Transactions[​](#advanced-transactions "Direct link to Advanced Transactions")

* Batch operations: [Execute multiple transactions](https://docs.candide.dev/wallet/guides/getting-started/.md#step-4-create-useroperation) atomically
* Spending controls: [Set limits and policies](https://docs.candide.dev/wallet/plugins/allowance.md) for subscriptions and recurring payments

### Security[​](#security "Direct link to Security")

* Account recovery: [Social Recovery](https://docs.candide.dev/wallet/plugins/recovery-with-guardians.md) or [traditional](https://docs.candide.dev/wallet/recovery/auth-api.md) recovery options
* Multi-signature: A single account controlled with [multiple signatures](https://docs.candide.dev/wallet/guides/multisig.md)

## Developer Tools[​](#developer-tools "Direct link to Developer Tools")

| Tool                                                                                  | What it does                                                                                                    |
| ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| [AbstractionKit SDK](https://docs.candide.dev/wallet/abstractionkit/introduction.md) | TypeScript library for building and sending UserOperations. First-class support for Safe and EIP-7702 accounts. |
| [Bundler](https://docs.candide.dev/wallet/bundler/rpc-methods.md)                    | ERC-4337 compliant nodes for submitting UserOperations on all major EVM chains                                  |
| [Paymaster](https://docs.candide.dev/wallet/paymaster/rpc-methods.md)                | Sponsor gas or accept ERC-20 token payments with configurable policies                                          |
| [InstaGas](https://docs.candide.dev/instagas/overview.md)                            | No-code dashboard to set gas sponsorship rules. No Solidity required                                            |
| [Account Recovery](https://docs.candide.dev/wallet/recovery/overview.md)             | Email/SMS recovery with an alert system and automatic on-chain execution                                        |

Access [Candide's Dashboard](https://dashboard.candide.dev) to get API keys and configure your integration.

## Chains Supported[​](#chains-supported "Direct link to Chains Supported")

Candide is available on all major EVM equivalent networks. Reach out if you need a network added.

<!-- -->

![Ethereum](/img/networks/1.png)Ethereum

![Arbitrum](/img/networks/42161.png)Arbitrum

![Optimism](/img/networks/10.png)Optimism

![Polygon](/img/networks/137.png)Polygon

![Gnosis](/img/networks/100.svg)Gnosis

![Base](/img/networks/8453.png)Base

![Celo](/img/networks/5567.png)Celo

![Plasma](/img/networks/9745.svg)Plasma

![BnB Chain](/img/networks/56.png)BnB Chain

![World Chain](/img/networks/480.svg)World Chain

![Avalanche](/img/networks/43114.png)Avalanche

## Support & Feedback[​](#support--feedback "Direct link to Support & Feedback")

* Join our [Discord](https://discord.gg/7R4g9XcxDQ)
* Twitter: [@candidelabs](https://twitter.com/candidelabs)
* Email: <team@candidelabs.com>
* Telegram: [@heymarcopolo](https://t.me/heymarcopolo)

We have night owls and early birds on the team. Expect a reply regardless of your timezone.
