near-ca
v0.7.3
Published
An SDK for controlling Ethereum Accounts from a Near Account.
Downloads
1,390
Readme
NEAR Chain Abstraction Layer (NEAR-CA)
DISCLAIMER: This should only be used for educational purposes.
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
: Eithernear
ortestnet
.
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
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
: Eithernear
ortestnet
.
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
:
- Create a mintbase wallet, super easy, here: https://wallet.bitte.ai/
- Your
XYZ.testnet
is yourNEAR_ACCOUNT_ID
. - In mintbase, on the top right corner click on the gear (settings) icon.
- Go to "Security & Recovery" -> "Export Account".
- After the exporting is complete click on "Private Key" and copy it.
- Paste it to
NEAR_ACCOUNT_PRIVATE_KEY
in your.env
file.