@nilfoundation/niljs
Classes
| Class | Description |
|---|---|
| BlockNotFoundError | The error class for 'block not found' errors. This error is thrown when the requested block is not found. |
| CometaService | CometaService is a client that interacts with the Cometa service. Cometa service is used to store contract metadata: source code, ABI, etc. CometaService |
| ExternalMessageEnvelope | The envelope for an external message (a message sent by a user, a dApp, etc.) |
| Faucet | The Faucet is a special contract that is used to top up other contracts in the =nil; devnet. |
| FaucetClient | FaucetClient is a client that interacts with the faucet api. It is used to get information about the faucet and to top up the account with custom currencies. FaucetClient |
| HttpTransport | HttpTransport represents the HTTP transport for connecting to the network. |
| IntegerOutOfRangeError | The error class for 'integer out of range' errors. This error is thrown when the requested integer is out of range. |
| InternalMessageEnvelope | The envelope for an internal message (a message sent by a smart contract to another smart contract). |
| InvalidShardIdError | The error class for invalid shard ID. This error is thrown when the provided shard ID is invalid. |
| ITransport | The transport interface. |
| LocalECDSAKeySigner | The LocalKeySigner is a class that allows for signing data with the private key. It uses the secp256k1 curve implementation by the @noble/curves/secp256k1 library. |
| PublicClient | PublicClient is a class that allows for interacting with the network via the JSON-RPC API. It provides an abstraction of the connection to =nil;. PublicClient enables using API requests that do not require signing data (or otherwise using one's private key). |
| WalletV1 | WalletV1 is a class used for performing operations on the cluster that require authentication. |
Interfaces
| Interface | Description |
|---|---|
| IMessage | The interface for the message object. This object is used to represent a message in the client code. It may differ from the actual message object used inside the network. |
| ISigner | The interface for the Signer class |
Type Aliases
| Type alias | Description |
|---|---|
| AbiEventParametersToPrimitiveTypes | - |
| AbiEventParameterToPrimitiveType | - |
| AbiEventTopicToPrimitiveType | - |
| AbiItem | - |
| AbiItemArgs | - |
| AbiItemName | - |
| Block | The block type. Type T determines whether the block contains processed messages or just message hashes. |
| BlockTag | The block tag type. |
| CallParams | Represents the message call params. |
| CometaServiceConfig | The type representing the config for the Cometa service client. |
| CommonReadContractMethods | - |
| CommonWriteContractMethods | - |
| ContractConstructorArgs | - |
| ContractData | Contract data. |
| ContractErrorArgs | - |
| ContractErrorName | - |
| ContractEventArgs | - |
| ContractEventArgsFromTopics | - |
| ContractEventName | - |
| ContractFunctionArgs | - |
| ContractFunctionName | - |
| ContractFunctionParameters | - |
| ContractFunctionReturnType | - |
| DeployParams | Represents the params for deploying a smart contract. |
| EventDefinition | - |
| ExternalMessage | The external message type. |
| ExtractAbiFunctionForArgs | - |
| ExtractAbiItem | - |
| ExtractAbiItemForArgs | - |
| ExtractAbiItemNames | - |
| FaucetClientConfig | The type representing the config for the faucet client. |
| GetContractParams | - |
| GetEventArgs | - |
| GetValue | - |
| Hex | The hex type. |
| IAddress | IAddress type represents an address in hexadecimal format. |
| IClientBaseConfig | The client configuration that is shared between public and private clients. |
| IDeployData | - |
| IHttpTransportConfig | The interface representing the configuration of the HTTP transport. |
| ILocalKeySignerConfig | The interface for the configuration object of LocalKeySigner. |
| ILog | The log interface. |
| IPrivateKey | IPrivateKey represents a private key in hexadecimal format. |
| IPublicClientConfig | The type representing the config for the public client. |
| IReceipt | The receipt interface. |
| ISendMessageOptions | The options for sending a message. |
| ISignature | The interface for the signature. It contains the r, s, and yParity values. |
| ISignedMessage | The signed message interface. |
| IWalletClientConfig | The type representing the config for the basic wallet. |
| Location | Location. |
| LogTopic | - |
| LogTopicType | - |
| MaybeAbiEventName | - |
| MaybeExtractEventArgsFromAbi | - |
| ProcessedReceipt | - |
| ReadContractParameters | - |
| RequestParams | Represents the params for making a request to the wallet. |
| SendAbiMessageParams | - |
| SendBaseMessageParams | - |
| SendDataMessageParams | - |
| SendMessageParams | Represents the params for sending a message. |
| SendSyncAbiMessageParams | - |
| SendSyncBaseMessageParams | - |
| SendSyncDataMessageParams | - |
| SendSyncMessageParams | Represents the params for sending a message synchronously. |
| Token | The structure representing a custom currency. |
| TopUpParams | The parameters for the top up request. |
| UnionEvaluate | - |
| UnionWiden | - |
| WalletV1Config | Represents the wallet configuration. |
| Widen | - |
| WriteContractParameters | - |
Variables
| Variable | Description |
|---|---|
| SszMessageSchema | The SSZ schema for a message object. |
| SszSignedMessageSchema | SSZ schema for a signed message object. Includes auth data in addition to all other message fields. |
Functions
| Function | Description |
|---|---|
| addHexPrefix | Add the hex prefix to the hex string. |
| bytesToHex | - |
| bytesToString | Converts bytes to a string. |
| calculateAddress | Calculates an address. |
| concatHex | Concatenates an array of hex strings. The hex strings are concatenated without the "0x" prefix. The resulting hex string will have the "0x" prefix. |
| contractInteraction | - |
| convertEthToWei | - |
| externalDeploymentMessage | Creates a new external deployment message. |
| externalMessageEncode | Encodes the given external message. |
| generateRandomKeyPair | Generate a new private key and its corresponding public key. |
| generateRandomPrivateKey | Generate a new private key. |
| getAddressFromPublicKey | Returns the address from the public key. |
| getContract | - |
| getPublicKey | Returns the public key from the private key using the secp256k1 curve. |
| getShardIdFromAddress | Returns the ID of the shard containing the provided address. |
| hexToBigInt | Converts a hex string to a bigint. |
| hexToBytes | Converts a hex string to a byte array. |
| hexToNumber | Converts a hex string to a number. |
| isAddress | Checks if the value is an address. If the value is an address, returns true. Otherwise, returns false. |
| isHexString | Checks if the value is a hex string. If the value is a hex string, returns true. Otherwise, returns false. |
| isValidBlock | Checks if the provided block is valid. |
| poseidonHash | - |
| refineAddress | Refines the address. |
| removeHexPrefix | Remove the hex prefix from the hex string. |
| toHex | Converts a string, number, bigint, boolean, or ByteArrayType to a hex string. |
| waitTillCompleted | Makes it so that the client waits until the processing of the message whose hash is passed. |
| writeContract | - |