thirdweb TypeScript SDK

# @thirdweb-dev/contracts-js

Latest version **1.3.23** (published 2024-05-10) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @thirdweb-dev/contracts-js
pnpm add @thirdweb-dev/contracts-js
yarn add @thirdweb-dev/contracts-js
bun add @thirdweb-dev/contracts-js
```

## Health

**Score 40/100 (D)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads; large bundle.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 1.3.23 |
| Published | 2024-05-10 |
| First published | 2022-08-29 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 30.2 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 639 |
| Maintainers | furqantw, yash90, krishang, jakeloo, joaquim-verges, jnsdls |

## Links

- npm: https://www.npmjs.com/package/@thirdweb-dev/contracts-js
- Repository: https://github.com/thirdweb-dev/js.git#main
- Homepage: https://github.com/thirdweb-dev/js/tree/main#readme
- Issues: https://github.com/thirdweb-dev/js/issues
- npm.io page: https://npm.io/package/@thirdweb-dev/contracts-js

## Dependencies (1)

- [@thirdweb-dev/contracts](https://npm.io/package/@thirdweb-dev/contracts.md) 3.15.0

## Recent versions

- 1.3.23 (latest) — 2024-05-10
- 0.0.0-dev-f95024147f012f9b752b6cd2215199dca870c39d-20240511003159 (dev) — 2024-05-11
- 1.3.23-nightly-ad24d83b5123f76b30268a755ff739a79f29f4af-20240510215849 (nightly) — 2024-05-10
- 1.3.18-beta-e0fc73388320fc7bb178beddd489aef9853a280c-20240320050555 (beta) — 2024-03-20
- 1.1.8-pr19-9e6a4dc (pr19) — 2022-09-03
- 0.0.0-dev-bd03ffef9e57f12d9ceb57fa26c4c56781f381db-20240510221023 — 2024-05-10
- 1.3.23-nightly-9d410c6a5409848fa6c7cc4f1c0fc6ec3a6fa6e8-20240510213648 — 2024-05-10
- 1.3.23-nightly-02c03196ad38de888ff86311c68fa010018bda60-20240510212518 — 2024-05-10
- 1.3.22 — 2024-05-01
- 1.3.22-nightly-75e66b189d790778358edeacdd71965f248902c2-20240501094148 — 2024-05-01
- 1.3.22-nightly-d2541e5d2ce9df443b6d5611161846169a3a58dd-20240501092938 — 2024-05-01
- 1.3.22-nightly-0bce5350946d0ce231a65dbad2493d1fbe0c1376-20240501084254 — 2024-05-01
- 1.3.22-nightly-88886acd762e637ac130bb7fa0eda12c6e5da4fc-20240501020428 — 2024-05-01
- 1.3.22-nightly-1d669547fb4f8a873194e0b843a9ca71e7e1504e-20240501015002 — 2024-05-01
- 1.3.21 — 2024-04-07
- … 628 more at https://npm.io/package/@thirdweb-dev/contracts-js/versions

## README

<p align="center">
    <br />
    <a href="https://thirdweb.com">
        <img src="https://thirdweb.com/brand/thirdweb-icon.svg" width="200" alt=""/></a>
    <br />
</p>

<h1 align="center"><a href='https://thirdweb.com/'>thirdweb</a> TypeScript SDK</h1>

<p align="center">
    <a href="https://github.com/thirdweb-dev/js/actions/workflows/CI.yml">
        <img alt="Build Status" src="https://github.com/thirdweb-dev/js/actions/workflows/CI.yml/badge.svg"/>
    </a>
</p>

<p align="center"><strong>All-in-one web3 SDK for Browser, Node and Mobile apps</strong></p>

## Core Package

#### [`thirdweb`](./packages/thirdweb/README.md)

The main SDK package providing all-in-one web3 functionality for Browser, Node, and Mobile applications.

```bash
npm install thirdweb
```

**Features:**

- Type-safe contract and transaction APIs
- In-app wallets with social/email login
- Account abstraction (ERC4337/EIP7702) support
- 500+ external wallets supported
- Built in infra (RPC, bundler, paymaster, indexer)
- React hooks and UI components
- Automatic ABI resolution
- IPFS upload/download
- Cross-platform support (Web, React Native)

### Documentation

Visit the [developer portal](https://portal.thirdweb.com) for full documentation.

### 🚀 Quick Start

#### For React Applications

```bash
npm install thirdweb
```

```typescript
import { createThirdwebClient } from "thirdweb";
import { ConnectButton, useActiveAccount } from "thirdweb/react";

const client = createThirdwebClient({
  clientId: "YOUR_CLIENT_ID",
});

function App() {
  const account = useActiveAccount();
  console.log("Connected as", account?.address);

  return <ConnectButton client={client} />;
}
```

For React Native Applications, you'll also need to install the `@thirdweb-dev/react-native-adapter` package and import it at app startup for polyfills.

#### For Backend Applications

```bash
npm install thirdweb
```

```typescript
import { createThirdwebClient, Engine } from "thirdweb";

const client = createThirdwebClient({
  secretKey: "YOUR_SECRET_KEY",
});

const wallet = Engine.serverWallet({
  client,
  address: "0x...",
});

const transaction = transfer({
  contract: getContract({
    client,
    address: "0x...", // token contract
    chain: defineChain(1),
  }),
  to: "0x...", // recipient
  amount: "0.01", // amount in tokens
});

await wallet.enqueueTransaction({
  transaction,
});
```

## Adapters

#### [`@thirdweb-dev/react-native-adapter`](./packages/react-native-adapter/README.md)

Required polyfills and configuration for running the thirdweb SDK in React Native applications.

```bash
npm install @thirdweb-dev/react-native-adapter
```

#### [`@thirdweb-dev/wagmi-adapter`](./packages/wagmi-adapter/README.md)

Integration layer for using thirdweb's in-app wallets with wagmi.

```bash
npm install @thirdweb-dev/wagmi-adapter
```

## Type safe API wrappers

#### [`@thirdweb-dev/api`](./packages/api/README.md)

TypeScript SDK for thirdweb's API, combining all of thirdweb products.

```bash
npm install @thirdweb-dev/api
```

#### [`@thirdweb-dev/engine`](./packages/engine/README.md)

TypeScript SDK for Engine, thirdweb's backend onchain executor service.

```bash
npm install @thirdweb-dev/engine
```

#### [`@thirdweb-dev/insight`](./packages/insight/README.md)

TypeScript SDK for Insight, thirdweb's multichain indexer service.

```bash
npm install @thirdweb-dev/insight
```

#### [`@thirdweb-dev/vault-sdk`](./packages/vault-sdk/README.md)

SDK for interacting with Vault, thirdweb's secure key management service.

```bash
npm install @thirdweb-dev/vault-sdk
```

#### [`@thirdweb-dev/nebula`](./packages/nebula/README.md)

TypeScript SDK for Nebula, thirdweb's AI agent service.

```bash
npm install @thirdweb-dev/nebula
```

## Contributing

We welcome contributions from all developers regardless of experience level. If you are interested in contributing, please read our [Contributing Guide](.github/contributing.md) to learn how the repo works, how to test your changes, and how to submit a pull request.

See our [open source page](https://thirdweb.com/open-source) for more information on our open-source bounties and program.

## Additional Resources

- [Dashboard](https://thirdweb.com/login)
- [Documentation](https://portal.thirdweb.com/)
- [Templates](https://thirdweb.com/templates)
- [YouTube](https://www.youtube.com/c/thirdweb)
- [X/Twitter](https://x.com/thirdweb)
- [Telegram](https://t.me/officialthirdweb)

## Support

For help or feedback, please [visit our support site](https://thirdweb.com/support)

## Security

If you believe you have found a security vulnerability in any of our packages, we kindly ask you not to open a public issue; and to disclose this to us by emailing `security@thirdweb.com`.

---
_Source: https://npm.io/package/@thirdweb-dev/contracts-js · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._