@asichain/asi-wallet-sdk 0.1.0

package/dist/services/Mnemonic/index.d.ts

@@ -0,0 +1,11 @@
+export declare enum MnemonicStrength {
+    TWELVE_WORDS = 128,
+    TWENTY_FOUR_WORDS = 256
+}
+export default class MnemonicService {
+    static generateMnemonic(strength?: MnemonicStrength): string;
+    static generateMnemonicArray(strength?: MnemonicStrength): string[];
+    static isMnemonicValid(mnemonic: string): boolean;
+    static mnemonicToWordArray(mnemonic: string): string[];
+    static wordArrayToMnemonic(words: string[]): string;
+}

package/dist/services/Resubmit/DeployResubmitter.d.ts

@@ -0,0 +1,22 @@
+import { ResubmitConfig, ResubmitResult } from "./types";
+import Wallet from "@domains/Wallet";
+import { PasswordProvider } from "@domains/Signer";
+export default class DeployResubmitter {
+    private readonly config;
+    private readonly nodeManager;
+    private readonly errorHandler;
+    private startSubmissionTime;
+    constructor(config: ResubmitConfig, availableNodesUrls: string[]);
+    private isDeployExpired;
+    private sleep;
+    private retryDeployToOneNode;
+    private retryDeployToRandomNodes;
+    private pollDeployStatus;
+    /**
+
+     * Main resubmit function
+     * Executes the complete resubmit algorithm for deploy
+     * NOT FOR "READ-ONLY" DEPLOYS (exploratory deploys)
+     */
+    resubmit(rholangCode: string, wallet: Wallet, passwordProvider: PasswordProvider, phloLimit?: number): Promise<ResubmitResult>;
+}

package/dist/services/Resubmit/NodeManager.d.ts

@@ -0,0 +1,22 @@
+import { NodeProvider } from "./types";
+export default class NodeManager implements NodeProvider {
+    private static instance;
+    private retriesLeft;
+    private readonly availableNodesUrls;
+    private readonly useRandomNode;
+    private readonly inactiveNodesUrls;
+    private currentNodeUrl;
+    private constructor();
+    static initialize(availableNodesUrls: string[], nodeSelectionAttempts?: number, useRandomNode?: boolean): NodeManager;
+    connectDefaultNode(): Promise<void>;
+    private connectNode;
+    static getInstance(): NodeManager;
+    isInitialized(): boolean;
+    private markNodeInactive;
+    deactivateCurrentNode(): void;
+    private deactivateNode;
+    private getAvailableNodesUrls;
+    getRetriesLeft(): number;
+    private getRandomAvailableNodeUrl;
+    connectActiveRandomNode(): Promise<void>;
+}

package/dist/services/Resubmit/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from "./DeployResubmitter";
+export { default as ResubmitNodeManager } from "./NodeManager";
+export { type ResubmitConfig, type ResubmitResult, } from "./types";

package/dist/services/Resubmit/types.d.ts

@@ -0,0 +1,32 @@
+import { DeploymentErrorType, FatalDeployErrors, RecoverableDeployErrors, DeploymentErrorHandler } from "@domains/Error";
+import BlockchainGateway, { type DeployStatusResult, DeployStatus } from '@domains/BlockchainGateway';
+export { DeployStatus, DeployStatusResult, DeploymentErrorHandler, RecoverableDeployErrors, FatalDeployErrors, BlockchainGateway };
+export interface NodeProvider {
+    connectDefaultNode(): Promise<void>;
+    connectActiveRandomNode(): Promise<void>;
+    deactivateCurrentNode(): void;
+    isInitialized(): boolean;
+    getRetriesLeft(): number;
+}
+export interface ResubmitConfig {
+    phloPrice: number;
+    useRandomNode: boolean;
+    deployValiditySeconds: number;
+    nodeSelectionAttempts: number;
+    deployRetries: number;
+    deployIntervalSeconds: number;
+    pollingIntervalSeconds: number;
+}
+export interface ErrorDetail {
+    blockchainError?: {
+        type: DeploymentErrorType;
+        message: string;
+    };
+    exceededTimeout?: FatalDeployErrors.DEPLOY_SUBMIT_TIMEOUT | FatalDeployErrors.BLOCK_INCLUSION_TIMEOUT;
+}
+export interface ResubmitResult {
+    success: boolean;
+    deployId?: string;
+    deployStatus?: DeployStatus;
+    error?: ErrorDetail;
+}

package/dist/services/Signer/index.d.ts

@@ -0,0 +1,5 @@
+import { SigningRequest, PasswordProvider, SignedResult } from "@domains/Signer";
+export default class SignerService {
+    static sign(request: SigningRequest, passwordProvider: PasswordProvider): Promise<SignedResult>;
+    private static readonly deployDataProtobufSerialize;
+}

package/dist/services/Transfer/index.d.ts

@@ -0,0 +1,11 @@
+import Wallet, { Address } from "@domains/Wallet";
+import { PasswordProvider } from "@domains/Signer";
+export default class AssetsService {
+    transfer(fromAddress: string, toAddress: string, amount: bigint, wallet: Wallet, passwordProvider: PasswordProvider, phloLimit?: number): Promise<string | undefined>;
+    /**
+     * Get ASI token balance for an address
+     * @param address The address to check balance for
+     * @returns Balance in smallest units (bigint)
+     */
+    getASIBalance(address: Address): Promise<bigint>;
+}

package/dist/services/Wallets/index.d.ts

@@ -0,0 +1,16 @@
+import { Address } from "@domains/Wallet";
+export interface CreateWalletOptions {
+    name?: string;
+}
+export interface WalletMeta {
+    address: string;
+    privateKey: Uint8Array;
+    publicKey?: Uint8Array;
+    mnemonic?: string;
+}
+export default class WalletsService {
+    static createWallet(privateKey?: Uint8Array, options?: CreateWalletOptions): WalletMeta;
+    static createWalletFromMnemonic(mnemonic?: string, index?: number): Promise<WalletMeta>;
+    static deriveAddressFromPrivateKey(privateKey: Uint8Array): Address;
+    static deriveAddressFromPublicKey(publicKey: Uint8Array): Address;
+}

package/dist/services/index.d.ts

@@ -0,0 +1,19 @@
+export * from "./Fee";
+export * from "./Crypto";
+export * from "./Wallets";
+export * from "./Mnemonic";
+export * from "./KeysManager";
+export * from "./KeyDerivation";
+export * from "./Resubmit";
+export * from "./Signer";
+export * from "./AssetsService";
+export { default as KeyDerivationService } from "./KeyDerivation";
+export { default as BinaryWriter } from "./BinaryWriter";
+export { default as MnemonicService } from "./Mnemonic";
+export { default as KeysManager } from "./KeysManager";
+export { default as WalletsService } from "./Wallets";
+export { default as CryptoService } from "./Crypto";
+export { default as FeeService } from "./Fee";
+export { default as DeployResubmitter } from "./Resubmit";
+export { default as SignerService } from "./Signer";
+export { default as AssetsService } from "./AssetsService";

package/dist/utils/codec/index.d.ts

@@ -0,0 +1,6 @@
+export declare const encodeBase58: (hex: string) => string;
+export declare const decodeBase58: (value: string) => Uint8Array;
+export declare const decodeBase16: (hex: string) => Uint8Array;
+export declare const encodeBase16: (bytes: Uint8Array) => string;
+export declare const arrayBufferToBase64: (buffer: ArrayBuffer) => string;
+export declare const base64ToArrayBuffer: (base64: string) => ArrayBuffer;

package/dist/utils/constants/index.d.ts

@@ -0,0 +1,24 @@
+export declare const PRIVATE_KEY_LENGTH = 32;
+export declare const ASI_CHAIN_PREFIX: {
+    coinId: string;
+    version: string;
+};
+export declare const ASI_COIN_TYPE = 60;
+export declare const ASI_DECIMALS = 8;
+export declare const GasFee: {
+    BASE_FEE: number;
+    VARIATION_RANGE: number;
+    LABEL: string;
+    TRANSFER: string;
+    DEPLOY: string;
+};
+export declare const POWER_BASE: number;
+export declare const ASI_BASE_UNIT: bigint;
+export declare const FAULT_TOLERANCE_THRESHOLD: number;
+export declare const INVALID_BLOCK_NUMBER = -1;
+export declare const DEFAULT_BIP_44_PATH_OPTIONS: {
+    coinType: number;
+    account: number;
+    change: number;
+    index: number;
+};

package/dist/utils/functions/index.d.ts

@@ -0,0 +1,5 @@
+export declare const toAtomicAmount: (amount: number | string) => bigint;
+export declare const fromAtomicAmountToString: (atomicAmount: bigint) => string;
+export declare const fromAtomicAmountToNumber: (atomicAmount: bigint) => number;
+export declare const fromAtomicAmount: (atomicAmount: bigint) => string;
+export declare const genRandomHex: (size: number) => string;

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./codec";
+export * from "./constants";
+export * from "./functions";
+export * from "./polyfills";
+export * from "./validators";

package/dist/utils/polyfills/index.d.ts

@@ -0,0 +1 @@
+export declare const setupBufferPolyfill: () => void;

package/dist/utils/validators/index.d.ts

@@ -0,0 +1,21 @@
+import type { Address } from "@domains/Wallet";
+export declare const validateAccountName: (name: string, maxLength?: number) => {
+    isValid: boolean;
+    error?: string;
+};
+export declare enum AddressValidationErrorCode {
+    INVALID_PREFIX = "INVALID_PREFIX",
+    INVALID_LENGTH = "INVALID_LENGTH",
+    INVALID_ALPHABET = "INVALID_ALPHABET",
+    INVALID_BASE58 = "INVALID_BASE58",
+    INVALID_HEX_LENGTH = "INVALID_HEX_LENGTH",
+    INVALID_CHAIN_PREFIX = "INVALID_CHAIN_PREFIX",
+    INVALID_CHECKSUM = "INVALID_CHECKSUM",
+    NON_CANONICAL = "NON_CANONICAL"
+}
+export interface AddressValidationResult {
+    isValid: boolean;
+    errorCode?: AddressValidationErrorCode;
+}
+export declare const validateAddress: (address: string) => AddressValidationResult;
+export declare const isAddress: (address: string) => address is Address;

package/package.json

@@ -0,0 +1,53 @@
+{
+    "version": "0.1.0",
+    "name": "@asichain/asi-wallet-sdk",
+    "description": "ASI Wallet SDK",
+    "license": "Apache-2.0",
+    "type": "module",
+    "main": "dist/index.cjs.js",
+    "module": "dist/index.esm.js",
+    "types": "dist/index.d.ts",
+    "sideEffects": false,
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "dev": "tsc -p tsconfig.build.json --emitDeclarationOnly && rollup -c -w",
+        "build": "tsc -p tsconfig.build.json --emitDeclarationOnly && rollup -c",
+        "test:security": "node scripts/security/run-security-tests.mjs",
+        "check:secret-logs": "node scripts/security/check-secret-logs.mjs",
+        "security:gate": "npm run build && npm run test:security && npm run check:secret-logs && npm audit --omit=dev"
+    },
+    "devDependencies": {
+        "@rollup/plugin-alias": "^5.0.0",
+        "@rollup/plugin-commonjs": "^25.0.0",
+        "@rollup/plugin-node-resolve": "^15.0.1",
+        "@rollup/plugin-terser": "^0.1.0",
+        "@rollup/plugin-typescript": "^11.1.0",
+        "@types/node": "^25.4.0",
+        "rollup": "^3.27.0",
+        "rollup-plugin-dts": "^6.3.0",
+        "tsx": "^4.20.6",
+        "tslib": "^2.8.1",
+        "typescript": "^5.9.3"
+    },
+    "dependencies": {
+        "@noble/hashes": "^1.6.0",
+        "@noble/secp256k1": "^1.7.0",
+        "axios": "^1.13.2",
+        "bip32": "^4.0.0",
+        "bip39": "^3.1.0",
+        "blakejs": "^1.2.1",
+        "bs58": "^6.0.0",
+        "buffer": "^6.0.3",
+        "js-sha3": "^0.9.3",
+        "tiny-secp256k1": "^2.2.4"
+    },
+    "exports": {
+        ".": {
+            "import": "./dist/index.esm.js",
+            "require": "./dist/index.cjs.js"
+        }
+    }
+}