near-ca

NEAR Chain Abstraction Layer (NEAR-CA)

NEAR-CA is a TypeScript library designed to provide an abstraction layer for interacting with the NEAR blockchain, simplifying the process of performing transactions and managing accounts on both NEAR and Ethereum chains. This library is intended for use in server-side applications only.

Features

• EVM Account Derivation from NEAR blockchain.
• Transaction signing and sending on the Ethereum blockchain.
• Key derivation functions for cryptographic operations.
• Support for EIP-1559 transactions on Ethereum.
• Wallet Connect intergration tools.

Contracts

Get Started

This project requires Node.js version 20.0.0 or higher. If you are using nvm, you can run nvm use to use the node version specified in .nvmrc.

To install dependencies and set up the project:

# Install dependencies
yarn
# Credentials
cp .env.example .env  <---- paste your Near credentials
# Send Eth. You'll need to fund your account first.
# More details in the 'Fund your account' part of this document
npx tsx examples/send-eth.ts

NEAR Credentials

Before using NEAR-CA, ensure you have the following environment variables set in your .env file:

• NEAR_ACCOUNT_ID: Your NEAR account identifier.
• NEAR_ACCOUNT_PRIVATE_KEY: Your NEAR account private key.
• MPC_CONTRACT_ID: The NEAR contract that handles multichain operations.
• NETWORK: Either near or testnet.

Copy the .env.example file and add these values to the .env file.

For setting up a wallet, use the NEAR testnet wallet. The testnet wallet is different from the main wallet. For example, you can use the Mintbase Wallet.

Fund your account

Get your address

npx tsx examples/getEthAddress.ts

After getting your address fund it from one of your own wallets.

Examples

CLI

For Ethereum, you can derive addresses, create payloads for transactions, and send signed transactions.

For more detailed examples, see the Examples README.

Frontend

To install NEAR-CA in your project, run the following command:

yarn add near-ca

Example: Setup NearEthAdapter and Send ETH

Here's an example of how to set up the NearEthAdapter and send ETH:

import dotenv from "dotenv";
import { setupAdapter } from "near-ca";

dotenv.config();
const { NEAR_ACCOUNT_ID, NEAR_ACCOUNT_PRIVATE_KEY } = process.env;

const adapter = await setupAdapter({
  accountId: NEAR_ACCOUNT_ID!,
  privateKey: NEAR_ACCOUNT_PRIVATE_KEY!,
  mpcContractId: MPC_CONTRACT_ID!,
});

await adapter.signAndSendTransaction({
  receiver: "0xdeADBeeF0000000000000000000000000b00B1e5",
  amount: 1n,
  chainId: 11_155_111,
  // Optional: Set nearGas (default is 250 TGAS, which sometimes might not be sufficient)
});

Other Examples

Each of the following scripts can be run with

npx tsx examples/*.ts

1. (Basic) Send ETH
2. WETH
   • Deposit (aka wrap-ETH)
   • Withdraw (aka unwrap-ETH)
3. Transfer ERC721
4. (Advanced) Buy NFT On Opensea

Configuration

Before using NEAR-CA, ensure you have the following environment variables set in your .env file:

• NEAR_ACCOUNT_ID: Your NEAR account identifier.
• NEAR_ACCOUNT_PRIVATE_KEY: Your NEAR account private key.
• MPC_CONTRACT_ID: The NEAR contract that handles multichain operations.
• NETWORK: Either near or testnet.

Copy the .env.example file and add these values to the .env file.

Steps to get your NEAR_ACCOUNT_ID and NEAR_ACCOUNT_PRIVATE_KEY:

1. Create a mintbase wallet, super easy, here: https://wallet.bitte.ai/
2. Your XYZ.testnet is your NEAR_ACCOUNT_ID.
3. In mintbase, on the top right corner click on the gear (settings) icon.
4. Go to "Security & Recovery" -> "Export Account".
5. After the exporting is complete click on "Private Key" and copy it.
6. Paste it to NEAR_ACCOUNT_PRIVATE_KEY in your .env file.