@ai16z/plugin-bnb

This plugin enables interaction with the BNB Chain ecosystem, providing support for BNB Smart Chain, opBNB, and BNB Greenfield networks.

---

Configuration

Default Setup

By default, plugin-bnb is not enabled. To use it, simply add your private key and/or public key to the .env file. If private key is not provided, some actions will be disabled.

Security Note: Your private key grants full access to your associated funds. Store it securely and never share it with anyone. Do not commit or upload your .env file to version control systems like Git.

BNB_PRIVATE_KEY=your-private-key-here
BNB_PUBLIC_KEY=your-public-key-here

Custom RPC URLs

By default, the RPC URL is inferred from the viem/chains config. To use custom RPC URLs, add the following to your .env file:

BSC_PROVIDER_URL=https://your-custom-bsc-rpc-url
OPBNB_PROVIDER_URL=https://your-custom-opbnb-rpc-url

Provider

The Wallet Provider initializes with BSC as the default. It:

• Provides the context of the currently connected address and its balance.
• Creates Public and Wallet clients to interact with the supported chains.

---

Actions

Get Balance

Get the balance of an address on BSC. Just specify the:

• Chain
• Address
• Token

Example usage:

Get the USDC balance of 0x1234567890 on BSC.

Transfer

Transfer tokens from one address to another on BSC/opBNB. Just specify the:

• Chain
• Token
• Amount
• Recipient Address
• Data(Optional)

Example usage:

Transfer 1 BNB to 0xRecipient on BSC.

Swap

Swap tokens from one address to another on BSC. Just specify the:

• Chain(Only BSC is supported for now)
• Input Token
• Output Token
• Amount
• Slippage(Optional)

Example usage:

Swap 1 BNB to USDC on BSC.

Bridge

Bridge tokens from one chain to another on BSC/opBNB. Just specify the:

• From Chain
• To Chain
• From Token
• To Token
• Amount
• Recipient Address(Optional)

Example usage:

Bridge 1 BNB from BSC to opBNB.

Stake

Perform staking operations on BSC through Lista Dao. User will receive sliBNB(0xB0b84D294e0C75A6abe60171b70edEb2EFd14A1B) as staking credit. Just specify the:

• Chain(Only BSC is supported for now)
• Action
• Amount

Example usage:

Deposit 1 BNB to Lista Dao.

Faucet

Request testnet tokens from the faucet. You could request any of the supported tokens(BNB, BTC, BUSD, DAI, ETH, USDC). Just specify the:

• Token(Optional)
• Recipient Address

The faucet is rate-limited. One claim is allowed per IP address within a 24-hour period. And the recipient address must maintain a minimum balance of 0.002 BNB on BSC Mainnet to qualify.

Example usage:

Get some testnet USDC from the faucet.

---

Contribution

The plugin contains tests. Whether you're using TDD or not, please make sure to run the tests before submitting a PR.

Running Tests

Navigate to the plugin-bnb directory and run:

pnpm test