near-api-js

import { Account, JsonRpcProvider, teraToGas, KeyPairString, nearToYocto } from "near-api-js"; // Configure your connection to a NEAR testnet RPC endpoint const provider = new JsonRpcProvider({ url: "https://test.rpc.fastnear.com", }); // For read-only calls (e.g., viewing contract state), you can use the provider directly const messages = await provider.callFunction({ contractId: 'guestbook.near-examples.testnet', method: "get_messages", args: {}, }); console.log("Guestbook messages:", messages); // To modify blockchain state, you need an account with a signer (private key) const accountId: string = 'example.testnet'; // Replace with an actual account ID // WARNING: Never hardcode private keys in production. Use environment variables or secure key management. const privateKey = process.env.NEAR_PRIVATE_KEY ?? 'ed25519:YOUR_PRIVATE_KEY_HERE' as KeyPairString; if (privateKey === 'ed25519:YOUR_PRIVATE_KEY_HERE') { console.warn("WARNING: Please set the NEAR_PRIVATE_KEY environment variable or replace the placeholder in quickstart. The example will not modify state without a valid key."); } else { const account = new Account(accountId, provider, privateKey); // Call a mutable contract method to add a message const result = await account.callFunction({ contractId: 'guestbook.near-examples.testnet', methodName: "add_message", args: { text: `Hello from near-api-js at ${new Date().toISOString()}!` }, gas: teraToGas('30'), // Attach 30 TeraGas for execution deposit: nearToYocto('0.1'), // Attach 0.1 NEAR as deposit }); console.log("Transaction result:", result); }