@xelis/sdk 0.11.31 → 0.11.33

package/dist/types/contract/typed_contract.d.ts

@@ -9,14 +9,30 @@ export interface ABIEntry {
     name: string;
     outputs?: string | string[];
     params: ABIParam[];
-    type: 'entry' | 'view';
+    type: 'entry';
     description?: string;
 }
+export interface InternalType {
+    name: string;
+    kind: 'struct' | 'enum';
+    fields?: Array<{
+        name: string;
+        type: string;
+    }>;
+    variants?: Array<{
+        name: string;
+        fields: Array<{
+            name: string;
+            type: string;
+        }>;
+    }>;
+}
 export type ABI = {
     data: ABIEntry[];
     version: string;
+    internal_types?: InternalType[];
 };
-type ParamType<T extends string> = T extends 'Hash' ? string : T extends 'Address' ? string : T extends 'PublicKey' ? string : T extends 'Blob' ? string : T extends 'String' | 'string' ? string : T extends 'Boolean' | 'boolean' | 'bool' ? boolean : T extends 'U256' | 'u256' ? bigint | number : T extends 'U128' | 'u128' ? bigint | number : T extends 'U64' | 'u64' ? bigint | number : T extends 'U32' | 'u32' ? number : T extends 'U16' | 'u16' ? number : T extends 'U8' | 'u8' ? number : any;
+type ParamType<T extends string> = T extends 'Hash' ? string : T extends 'Address' ? string : T extends 'PublicKey' ? string : T extends 'Blob' ? string : T extends 'String' | 'string' ? string : T extends 'Boolean' | 'boolean' | 'bool' ? boolean : T extends 'U256' | 'u256' ? bigint | number : T extends 'U128' | 'u128' ? bigint | number : T extends 'U64' | 'u64' ? bigint | number : T extends 'U32' | 'u32' ? number : T extends 'U16' | 'u16' ? number : T extends 'U8' | 'u8' ? number : T extends `${infer Inner}[]` ? Array<ParamType<Inner>> : T extends `optional<${infer Inner}>` ? ParamType<Inner> | null | undefined : T extends `map<${infer K}, ${infer V}>` ? ParamType<K> extends string | number | symbol ? Record<ParamType<K>, ParamType<V>> : Record<string, ParamType<V>> : T extends `(${string})` ? any[] : any;
 type ExtractParams<T extends ABIEntry> = {
     [K in T['params'][number] as K['name']]: K extends {
         optional: true;
@@ -37,39 +53,58 @@ export declare class TypedContract<T extends ABI> {
     readonly abi: T;
     private readonly methods;
     constructor(address: string, abi: T);
+    /**
+     * Register all custom types from ABI
+     */
+    private register_internal_types;
+    /**
+     * Helper to create struct values with positional arguments
+     * Validates field types immediately
+     * @param type_name - Name of the struct type
+     * @param field_values - Field values in the order defined in ABI
+     */
+    struct(type_name: string, ...field_values: any[]): any;
+    /**
+     * Helper to create enum values with positional arguments
+     * Validates field types immediately
+     * @param type_name - Name of the enum type
+     * @param variant_name - Name of the variant
+     * @param field_values - Field values in the order defined in ABI
+     */
+    enum(type_name: string, variant_name: string, ...field_values: any[]): any;
     /**
      * Internal method to invoke contract functions
      */
-    invokeUnsafe(methodName: string, params?: any): Record<string, any>;
+    invokeUnsafe(method_name: string, params?: any): Record<string, any>;
     /**
      * Type-safe invoke method
      */
-    invoke<K extends T['data'][number]['name']>(methodName: K, params: K extends T['data'][number]['name'] ? T['data'][number] extends infer E ? E extends ABIEntry ? E['name'] extends K ? ExtractParams<E> : never : never : never : never): Record<string, any>;
+    invoke<K extends T['data'][number]['name']>(method_name: K, params: K extends T['data'][number]['name'] ? T['data'][number] extends infer E ? E extends ABIEntry ? E['name'] extends K ? ExtractParams<E> : never : never : never : never): Record<string, any>;
     /**
      * Get list of available methods
      */
-    getMethods(): string[];
+    get_methods(): string[];
     /**
      * Get method signature information
      */
-    getMethodSignature(methodName: string): ABIEntry | undefined;
+    get_method_signature(method_name: string): ABIEntry | undefined;
     /**
      * Generate TypeScript interface for the contract
      */
-    generateInterface(): string;
-    private getTypeScriptType;
+    generate_interface(): string;
+    private get_typescript_type;
 }
 /**
  * Create a typed contract instance with full TypeScript support
  */
-export declare function createTypedContract<T extends ABI>(address: string, abi: T): TypedContract<T> & MethodsFromABI<T>;
+export declare function create_typed_contract<T extends ABI>(address: string, abi: T): TypedContract<T> & MethodsFromABI<T>;
 /**
  * Contract factory with strong typing
  */
 export declare class TypedContractFactory<T extends ABI> {
     private readonly abi;
-    private readonly contractName;
-    constructor(abi: T, contractName?: string);
+    private readonly contract_name;
+    constructor(abi: T, contract_name?: string);
     /**
      * Create a new contract instance at the specified address
      */
@@ -77,18 +112,18 @@ export declare class TypedContractFactory<T extends ABI> {
     /**
      * Get the ABI
      */
-    getABI(): T;
+    get_abi(): T;
     /**
      * Generate TypeScript definitions for this contract
      */
-    generateTypeDefinitions(): string;
+    generate_type_definitions(): string;
 }
 /**
  * Utility to validate ABI structure
  */
-export declare function validateABI(abi: any): abi is ABI;
+export declare function validate_abi(abi: any): abi is ABI;
 /**
  * Helper to create a contract from JSON ABI
  */
-export declare function createContractFromJSON(address: string, abiPath: string): Promise<TypedContract<ABI> & MethodsFromABI<ABI>>;
+export declare function create_contract_from_json(address: string, abi_path: string): Promise<TypedContract<ABI> & MethodsFromABI<ABI>>;
 export {};

package/dist/types/contract/xvm_serializer.d.ts

@@ -23,14 +23,26 @@ export type ValidationType = keyof typeof TYPE_VALIDATORS;
  * @param type - The type string (e.g., 'u64', 'Hash', 'string')
  * @param validate - Whether to validate and convert the value (default: true)
  */
-export declare function createVMParameter(value: any, type: ValidationType, validate?: boolean): VMParameter;
+export declare function createVMPrimitive(value: any, type: ValidationType, validate?: boolean): VMParameter;
+/**
+ * Serialize an array of values
+ */
+export declare function serialize_array(items: any[], item_type: string): VMParameter;
+/**
+ * Serialize a map
+ */
+export declare function serialize_map(map: Record<string, any>, keyType: string, valueType: string): VMParameter;
+/**
+ * Serialize an optional value
+ */
+export declare function serialize_optional(value: any, inner_type: string): VMParameter;
 /**
  * Convenience functions for common types
  */
-export declare const vmParam: {
+export declare const VMParam: {
     hash: (value: string) => VMParameter;
     address: (value: string) => VMParameter;
-    publicKey: (value: string) => VMParameter;
+    public_key: (value: string) => VMParameter;
     blob: (value: string) => VMParameter;
     u64: (value: number | bigint) => VMParameter;
     u32: (value: number) => VMParameter;
@@ -39,6 +51,57 @@ export declare const vmParam: {
     string: (value: string) => VMParameter;
     boolean: (value: boolean) => VMParameter;
 };
+/**
+ * A type that knows how to serialize itself to VMParameter
+ */
+export interface SerializableType {
+    readonly name: string;
+    to_VMParameter(value: any): VMParameter;
+}
+/**
+ * Enum variant schema
+ */
+export interface EnumVariantSchema {
+    name: string;
+    fields: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+/**
+ * Struct field schema
+ */
+export interface StructFieldSchema {
+    name: string;
+    type: string;
+}
+/**
+ * Define an enum type from ABI schema
+ */
+export declare function defineEnum(name: string, variants: EnumVariantSchema[]): SerializableType;
+/**
+ * Define a struct type from ABI schema
+ */
+export declare function defineStruct(name: string, fields: StructFieldSchema[]): SerializableType;
+/**
+ * Type registry - simple Map for custom types
+ */
+declare class TypeRegistry {
+    private types;
+    register(definition: SerializableType): SerializableType;
+    get(name: string): SerializableType | undefined;
+    has(name: string): boolean;
+    clear(): void;
+    all(): Iterable<SerializableType>;
+}
+export declare const typeRegistry: TypeRegistry;
+/**
+ * Enhanced parameter creation that handles both primitive and custom types
+ * @param value - The value to serialize
+ * @param type - The type string (primitive or custom type name)
+ * @param validate - Whether to validate primitive values (default: true)
+ */
+export declare function createVMParameter(value: any, type: string, validate?: boolean): VMParameter;
 /**
  * Creates a deposits object for contract calls
  * @param deposits - Object mapping token hashes to amounts
@@ -51,8 +114,9 @@ export declare function createDeposits(deposits: Record<string, number | bigint>
  */
 export interface ContractInvocationParams {
     contract: string;
-    chunkId: number;
+    chunk_id: number;
     parameters?: VMParameter[];
+    permission: string;
     deposits?: Record<string, number | bigint>;
     maxGas?: number;
 }

package/dist/types/daemon/rpc.d.ts

@@ -13,10 +13,14 @@ export declare class RPC extends HttpRPC {
     getStableHeight(): Promise<number>;
     getStableTopoheight(): Promise<number>;
     getHardForks(): Promise<types.HardFork[]>;
-    getBlockAtTopoheight(params: types.GetBlockAtTopoheightParams): Promise<types.Block>;
+    getBlockAtTopoheight(params: types.GetBlockAtTopoHeightParams): Promise<types.Block>;
     getBlocksAtHeight(params: types.GetBlocksAtHeightParams): Promise<types.Block[]>;
     getBlockByHash(params: types.GetBlockByHashParams): Promise<types.Block>;
     getTopBlock(params?: types.GetTopBlockParams): Promise<types.Block>;
+    getBlockDifficultyByHash(params: types.GetBlockDifficultyByHashParams): Promise<types.GetDifficultyResult>;
+    getBlockBaseFeeByHash(params: types.GetBlockBaseFeeByHashParams): Promise<types.GetBlockBaseFeeByHashResult>;
+    getBlockSummaryAtTopoheight(params: types.GetBlockAtTopoHeightParams): Promise<types.GetBlockSummaryResult>;
+    getBlockSummaryByHash(params: types.GetBlockSummaryByHashParams): Promise<types.GetBlockSummaryResult>;
     getBalance(params: types.GetBalanceParams): Promise<types.GetBalanceResult>;
     getStableBalance(params: types.GetBalanceParams): Promise<types.GetStableBalanceResult>;
     hasBalance(params: types.HasBalanceParams): Promise<types.HasBalanceResult>;
@@ -35,6 +39,7 @@ export declare class RPC extends HttpRPC {
     getTransationExecutor(hash: string): Promise<types.GetTransactionExecutorResult>;
     getTransaction(hash: string): Promise<types.TransactionResponse>;
     getTransactions(txHashes: string[]): Promise<types.TransactionResponse[]>;
+    getTransactionsSummary(params: types.GetTransactionsParams): Promise<types.TransactionSummary[]>;
     isTxExecutedInBlock(params: types.IsTxExecutedInBlockParams): Promise<boolean>;
     p2pStatus(): Promise<types.P2PStatusResult>;
     getPeers(): Promise<types.GetPeersResult>;
@@ -54,6 +59,7 @@ export declare class RPC extends HttpRPC {
     validateAddress(params: types.ValidateAddressParams): Promise<types.ValidateAddressResult>;
     splitAddress(params: types.SplitAddressParams): Promise<types.SplitAddressResult>;
     extractKeyFromAddress(params: types.ExtractKeyFromAddressParams): Promise<string | number[]>;
+    keyToAddress(params: types.KeyToAddressParams): Promise<types.Address>;
     makeIntegratedAddress(params: types.MakeIntegratedAddressParams): Promise<string>;
     decryptExtraData(params: types.DecryptExtraDataParams): Promise<unknown>;
     getMultisigAtTopoheight(params: types.GetMutilsigAtTopoheightParams): Promise<types.GetMutilsigAtTopoheightResult>;
@@ -63,6 +69,7 @@ export declare class RPC extends HttpRPC {
     getContractLogs(params: types.GetContractLogsParams): Promise<types.ContractLog[]>;
     getContractScheduledExecutionsAtTopoheight(params: types.GetContractScheduledExecutionsAtTopoheightParams): Promise<types.ScheduledExecution[]>;
     getContractRegisteredExecutionsAtTopoheight(params: types.GetContractScheduledExecutionsAtTopoheightParams): Promise<[number, string][]>;
+    getContractsOutputs(params: types.GetContractOutputsParams): Promise<types.GetContractsOutputsResult>;
     getContractModule(params: types.GetContractModuleParams): Promise<types.GetContractModuleResult>;
     getContractData(params: types.GetContractDataParams): Promise<unknown>;
     getContractDataAtTopoheight(params: types.GetContractDataAtTopoheightParams): Promise<unknown>;

package/dist/types/daemon/types.d.ts

@@ -40,6 +40,74 @@ export interface Block {
     txs_hashes: string[];
     transactions?: Transaction[];
 }
+export interface GetBlockDifficultyByHashParams {
+    block_hash: string;
+}
+export interface GetBlockBaseFeeByHashParams {
+    block_hash: string;
+}
+export interface GetBlockBaseFeeByHashResult {
+    fee_per_kb: number;
+    block_size_ema: number;
+}
+export interface TransactionSummary {
+    hash: string;
+    source: string;
+    fee: number;
+    size: number;
+}
+export interface GetBlockSummaryResult {
+    block_hash: string;
+    height: number;
+    miner: string;
+    timestamp: number;
+    block_type: BlockType;
+    cumulative_difficulty: string;
+    difficulty: string;
+    topoheight: number;
+    reward: number;
+    miner_reward: number;
+    dev_reward: number;
+    supply: number;
+    total_fees: number;
+    total_fees_burned: number;
+    transactions: TransactionSummary[];
+}
+export interface GetBlockSummaryByHashParams {
+    hash: string;
+}
+export interface GetTransactionsParams {
+    tx_hashes: string[];
+}
+export type KeyToAddressParams = string | number[];
+export declare enum AddressType {
+    Normal = "normal",
+    Data = "data"
+}
+export interface Address {
+    mainnet: boolean;
+    addr_type: AddressType;
+    key: any;
+}
+export interface ContractTransfersEntryKey {
+    contract: string;
+    caller: string;
+}
+export interface ContractTransfersEntry {
+    transfers: {
+        [hash: string]: number;
+    };
+}
+export interface GetContractsOutputsResult {
+    executions: Array<{
+        key: ContractTransfersEntryKey;
+        value: ContractTransfersEntry;
+    }>;
+}
+export interface GetContractOutputsParams {
+    address: string;
+    topoheight: number;
+}
 export interface GetBalanceParams {
     address: string;
     asset: string;
@@ -265,7 +333,7 @@ export interface GetAccountAssetsParams {
     skip?: number;
     maximum?: number;
 }
-export interface GetBlockAtTopoheightParams {
+export interface GetBlockAtTopoHeightParams {
     topoheight: number;
     include_txs?: boolean;
 }
@@ -322,6 +390,11 @@ export interface AccountHistory {
     deploy_contract?: {
         deposits?: string[];
     };
+    from_contract?: {
+        contract: string;
+        asset: string;
+        amount: number;
+    };
 }
 export interface PeerPeerListUpdated {
     peer_id: string;
@@ -768,6 +841,10 @@ export declare enum RPCMethod {
     GetBlocksAtHeight = "get_blocks_at_height",
     GetBlockByHash = "get_block_by_hash",
     GetTopBlock = "get_top_block",
+    GetBlockDifficultyByHash = "get_block_difficulty_by_hash",
+    GetBlockBaseFeeByHash = "get_block_base_fee_by_hash",
+    GetBlockSummaryAtTopoheight = "get_block_summary_at_topoheight",
+    GetBlockSummaryByHash = "get_block_summary_by_hash",
     GetBalance = "get_balance",
     GetStableBalance = "get_stable_balance",
     HasBalance = "has_balance",
@@ -786,9 +863,11 @@ export declare enum RPCMethod {
     GetTransactionExecutor = "get_transaction_executor",
     GetTransaction = "get_transaction",
     GetTransactions = "get_transactions",
+    GetTransactionsSummary = "get_transactions_summary",
     IsTxExecutedInBlock = "is_tx_executed_in_block",
     P2PStatus = "p2p_status",
     GetPeers = "get_peers",
+    GetP2PBlockPropagation = "get_p2p_block_propagation",
     GetMempool = "get_mempool",
     GetMempoolSummary = "get_mempool_summary",
     GetMempoolCache = "get_mempool_cache",
@@ -805,6 +884,7 @@ export declare enum RPCMethod {
     ValidateAddress = "validate_address",
     SplitAddress = "split_address",
     ExtractKeyFromAddress = "extract_key_from_address",
+    KeyToAddress = "key_to_address",
     MakeIntegratedAddress = "make_integrated_address",
     DecryptExtraData = "decrypt_extra_data",
     GetMultisigAtTopoheight = "get_multisig_at_topoheight",
@@ -814,6 +894,7 @@ export declare enum RPCMethod {
     GetContractLogs = "get_contract_logs",
     GetContractScheduledExecutionsAtTopoheight = "get_contract_scheduled_executions_at_topoheight",
     GetContractRegisteredExecutionsAtTopoheight = "get_contract_registered_executions_at_topoheight",
+    GetContractsOutputs = "get_contracts_outputs",
     GetContractModule = "get_contract_module",
     GetContractData = "get_contract_data",
     GetContractDataAtTopoheight = "get_contract_data_at_topoheight",
@@ -822,7 +903,6 @@ export declare enum RPCMethod {
     GetContractAssets = "get_contract_assets",
     GetContracts = "get_contracts",
     GetContractDataEntries = "get_contract_data_entries",
-    GetP2PBlockPropagation = "get_p2p_block_propagation",
     GetBlockTemplate = "get_block_template",
     GetMinerWork = "get_miner_work",
     SubmitBlock = "submit_block"

package/dist/types/daemon/websocket.d.ts

@@ -111,10 +111,14 @@ export declare class DaemonMethods {
     getStableHeight(): Promise<number>;
     getStableTopoheight(): Promise<number>;
     getHardForks(): Promise<types.HardFork[]>;
-    getBlockAtTopoheight(params: types.GetBlockAtTopoheightParams): Promise<types.Block>;
+    getBlockAtTopoheight(params: types.GetBlockAtTopoHeightParams): Promise<types.Block>;
     getBlocksAtHeight(params: types.GetBlocksAtHeightParams): Promise<types.Block[]>;
     getBlockByHash(params: types.GetBlockByHashParams): Promise<types.Block>;
     getTopBlock(params: types.GetTopBlockParams): Promise<types.Block>;
+    getBlockDifficultyByHash(params: types.GetBlockDifficultyByHashParams): Promise<types.GetDifficultyResult>;
+    getBlockBaseFeeByHash(params: types.GetBlockBaseFeeByHashParams): Promise<types.GetBlockBaseFeeByHashResult>;
+    getBlockSummaryAtTopoheight(params: types.GetBlockAtTopoHeightParams): Promise<types.GetBlockSummaryResult>;
+    getBlockSummaryByHash(params: types.GetBlockSummaryByHashParams): Promise<types.GetBlockSummaryResult>;
     getBalance(params: types.GetBalanceParams): Promise<types.GetBalanceResult>;
     getStableBalance(params: types.GetBalanceParams): Promise<types.GetStableBalanceResult>;
     hasBalance(params: types.HasBalanceParams): Promise<types.HasBalanceResult>;
@@ -133,6 +137,7 @@ export declare class DaemonMethods {
     getTransactionExecutor(hash: string): Promise<types.GetTransactionExecutorResult>;
     getTransaction(hash: string): Promise<types.TransactionResponse>;
     getTransactions(txHashes: string[]): Promise<types.TransactionResponse[]>;
+    getTransactionsSummary(params: types.GetTransactionsParams): Promise<types.TransactionSummary[]>;
     isTxExecutedInBlock(params: types.IsTxExecutedInBlockParams): Promise<boolean>;
     p2pStatus(): Promise<types.P2PStatusResult>;
     getPeers(): Promise<types.GetPeersResult>;
@@ -152,6 +157,7 @@ export declare class DaemonMethods {
     validateAddress(params: types.ValidateAddressParams): Promise<types.ValidateAddressResult>;
     splitAddress(params: types.SplitAddressParams): Promise<types.SplitAddressResult>;
     extractKeyFromAddress(params: types.ExtractKeyFromAddressParams): Promise<string | number[]>;
+    keyToAddress(params: types.KeyToAddressParams): Promise<types.Address>;
     makeIntegratedAddress(params: types.MakeIntegratedAddressParams): Promise<string>;
     decryptExtraData(params: types.DecryptExtraDataParams): Promise<unknown>;
     getMultisigAtTopoheight(params: types.GetMutilsigAtTopoheightParams): Promise<types.GetMutilsigAtTopoheightResult>;
@@ -161,6 +167,7 @@ export declare class DaemonMethods {
     getContractLogs(params: types.GetContractLogsParams): Promise<types.ContractLog[]>;
     getContractScheduledExecutionsAtTopoheight(params: types.GetContractScheduledExecutionsAtTopoheightParams): Promise<types.ScheduledExecution[]>;
     getContractRegisteredExecutionsAtTopoheight(params: types.GetContractScheduledExecutionsAtTopoheightParams): Promise<[number, string][]>;
+    getContractsOutputs(params: types.GetContractOutputsParams): Promise<types.GetContractsOutputsResult>;
     getContractModule(params: types.GetContractModuleParams): Promise<types.GetContractModuleResult>;
     getContractData(params: types.GetContractDataParams): Promise<unknown>;
     getContractDataAtTopoheight(params: types.GetContractDataAtTopoheightParams): Promise<unknown>;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.11.31",
+  "version": "0.11.33",
   "name": "@xelis/sdk",
   "description": "Xelis software development kit for JS",
   "exports": {