Constructing transactions on NEAR

This repository serves to demonstrate how transactions are created, signed, and sent to the NEAR blockchain.

Prerequisites:

• Current version of Node.js. >=v14.0.0
• Private key of the sender's account
  • If the account was created using near-cli or you ran near login in your terminal, the private key can be found in a .json file located in /HOME/.near-credentials.
  • If the account was created using NEAR Wallet, the key can be found in the browser's Local Storage (in your browser's Developer tools... Application >> Storage >> Local Storage). Watch this short video to learn how to get it.

Setup:

1. Setup an environment variable SENDER_PRIVATE_KEY with the private key of the sender's account.

Either create a .env file in the root of this project, or export a bash variable by running the following in your terminal (replacing the example key).

export SENDER_PRIVATE_KEY=3wb4fVQvafPebkcCmyQPgMa2VsnX3JAQXZ4gjpc3kSu9AbVtLpLZqEog4xTbJrJxG1Y88SkHpuJV58GmPRnPXMD

2. Install dependencies by running:

npm i

Examples:

Send Tokens (High Level)

send-tokens-easy.js will show you the easiest (JavaScript) way to send NEAR tokens (Ⓝ) using a near-api-js method; account.sendMoney()

1. In send-tokens-easy.js, update:

• account IDs for sender and receiver.
• network ID (default is testnet)

2. Run the file and send those tokens!

node send-tokens-easy.js

Send Tokens (Low Level)

send-tokens-deconstructed.js completely dissects the transaction construction process and shows the lowest level way to send NEAR tokens (Ⓝ).

1. In send-tokens-deconstructed.js, update:

• account IDs for sender and receiver.
• network ID (testnet is default)

2. Enter the amount of Ⓝ you would like to send.
3. Run the file and send those tokens!

node send-tokens-deconstructed.js

For a detailed walk-through, see the create-transactions doc.

Happy coding! 🚀