Skip to content

Examples of how to construct, sign, and send transactions on the NEAR blockchain.

Notifications You must be signed in to change notification settings

deprecated-near-examples/transaction-examples

Repository files navigation

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
  1. 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)
  1. 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)
  1. Enter the amount of Ⓝ you would like to send.
  2. Run the file and send those tokens!
node send-tokens-deconstructed.js

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

Happy coding! 🚀

About

Examples of how to construct, sign, and send transactions on the NEAR blockchain.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published