simple-nil

nil client utils

This package is intended to simplify interaction with Nil blockchain during its DevNet phase and will probably be deprecated with the evolution of Nil.js

Table of Contents

• nil client utils
  • Table of Contents
  • Features
  • Installation
    • Peer Dependencies
  • Getting Started
    • XClient
      • Initialization
      • Connecting with a different config
    • XWallet
      • Initialization
      • Self-deployment
    • XContract
      • Connecting to an Existing Contract
      • Deploying a New Contract

Features

• Type-Safe Interactions: Leverages TypeScript's strong typing to ensure reliable and predictable blockchain interactions.
• Smart Contract Deployment: Easily deploy new smart contracts with customizable parameters.
• Message Handling: Send and manage messages with comprehensive receipt processing.
• Currency Management: Create and approve currencies within your wallet.

Installation

Ensure you have Yarn installed. Then, install the package using Yarn:

yarn add simple-nil

Peer Dependencies

This package relies on the following peer dependencies. Ensure they are installed in your project:

Install them using Yarn:

yarn add @nilfoundation/niljs viem

Getting Started

XClient

The XClient class manages blockchain communications, handles external calls, and interacts with the underlying blockchain network. It serves as the bridge between your wallet and the blockchain, facilitating message sending and currency management.

Initialization

import { XClient } from "simple-nil";

const client = new XClient({
  shardId: 1,
  rpc: "https://rpc.endpoint.com",
  signerOrPrivateKey:
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
});

Connecting with a different config

If you need to connect the client with a different signer (private key), shardId or rpc, you can use the connect method:

const newSignerPrivateKey =
  "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef";

const newClient = client.connect({
  signerOrPrivateKey: newSignerPrivateKey
});

XWallet

The XWallet class provides functionalities to manage and interact with an XWallet instance on the blockchain. It allows for deploying contracts, approving spenders, creating currencies, and more.

Initialization

import { XWallet } from "simple-nil";
import { XWalletConfig } from "simple-nil/types";

const wallet = await XWallet.init({
  address: "0x0000167890abcdef1234567890abcdef12345678",
  rpc: "https://rpc.endpoint.com",
  signerOrPrivateKey:
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
});
console.log("Initialized XWallet:", wallet.address);

Self-deployment

import { XWallet, XClient } from "simple-nil";

const deployedWallet = await XWallet.deploy({
  shardId: 1,
  rpc: "https://rpc.endpoint.com",
  signerOrPrivateKey:
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
});
console.log("Deployed XWallet Address:", deployedWallet.address);

XContract

The XContract class provides functionalities to interact with deployed smart contracts. It allows connecting to existing contracts, deploying new ones, and invoking contract methods.

Connecting to an Existing Contract

import { XContract, XWallet } from "simple-nil";

// Assuming you have an initialized XWallet instance
const wallet = await XWallet.init(options);

// Define the ABI of your contract
const abi = [
  /* Your Contract ABI */
];

// Address of the deployed contract
const contractAddress = "0xabcdef1234567890abcdef1234567890abcdef12";

// Connect to the contract
const contract = XContract.connect(wallet, abi, contractAddress);

Deploying a New Contract

import { XContract, XWallet } from "simple-nil";

// Assuming you have an initialized XWallet instance
const wallet = await XWallet.init(options);

// Define the ABI and bytecode of your contract
const artifact = {
  abi: [
    /* Your Contract ABI */
  ],
  bytecode: "0x6001600101", // Replace with your contract's bytecode
};

// Constructor arguments for your contract
const args = [
  /* Constructor Arguments */
];

const shardId = 1;
const salt = BigInt(Date.now());

const newContract = await XContract.deploy(
  wallet,
  artifact,
  args,
  shardId,
  salt,
);
console.log("Deployed Contract Address:", newContract.address);