@rialo/ts-cdk 0.3.0-alpha.1 → 0.4.0-alpha.0

package/dist/index.d.mts

@@ -1503,7 +1503,7 @@ interface ValidatorInfoRequest {
     stateSyncAddress: string;
     /** Validator hostname. */
     hostname: string;
-    /** Authority public key. */
+    /** Identity public key. */
     authorityKey: string;
     /** Protocol public key. */
     protocolKey: string;
@@ -1614,6 +1614,8 @@ interface StakeAccountInfo {
     adminAuthority: string;
     /** Withdraw authority (cold wallet, base58). */
     withdrawAuthority: string;
+    /** Optional account that receives rewards instead of compounding (base58). */
+    rewardReceiver?: string;
 }
 /**
  * Request parameters for getValidatorAccounts.
@@ -1630,16 +1632,16 @@ interface ValidatorAccountInfo {
     commission: bigint;
     /** Public key of the validator info account (base58). */
     pubkey: string;
-    /** Node's public key / initial authorized withdrawer (base58). */
-    nodeIdentity: string;
-    /** Authority who can withdraw rewards (base58). */
-    authorizedWithdrawer: string;
-    /** Amount of token staked for next epoch. */
-    stakeNext: bigint;
-    /** Amount of token staked for current epoch (from last frozen snapshot). */
-    stakeCurrent?: bigint;
-    /** Network address for communicating with the validator. */
+    /** Signing key / initial withdrawal key (base58). */
+    signingKey: string;
+    /** Commission withdrawal key (base58). */
+    withdrawalKey: string;
+    /** Aggregate delegated stake for this validator. */
+    stake: bigint;
+    /** Network address for consensus communication. */
     address: string;
+    /** Network address for state synchronization. */
+    stateSyncAddress: string;
 }
 /**
  * SPL Token account balance information.
@@ -4503,4 +4505,134 @@ declare function getMainnetUrl(): string;
  */
 declare function getLocalnetUrl(): string;
 
-export { type AccountFilter, type AccountFilterParam, type AccountInfo, type AccountMeta, AccountMetaTable, type AllAccountsEntry, BASE_DERIVATION_PATH, BaseRpcClient, BincodeReader, type BincodeSchema, BincodeWriter, type BlockInfo, type Bump, CHACHA20_POLY1305_TAG_LENGTH, type ChainDefinition, type ClusterNodeInfo, type CompiledInstruction, type ConfigHashPrefix, type ConfirmTransactionOptions, type ConfirmedTransaction, type ConnectedNode, CryptoError, CryptoErrorCode, DEFAULT_NUM_ACCOUNTS, ED25519_PUBLIC_KEY_LENGTH, type EnumVariant, type EpochConsensusConfigRequest, type EpochInfo, type EventData, type FeeResponse, type GetAccountsByOwnerConfig, type GetAllAccountsConfig, type GetBlockConfig, type GetSignaturesForAddressConfig, type GetTransactionsConfig, type GetValidatorAccountsRequest, type GetWorkflowLineageRequest, type GetWorkflowLineageResponse, HPKE_ENC_LENGTH, HPKE_OVERHEAD_LENGTH, HpkeError, HpkeErrorCode, HttpTransport, type HttpTransportConfig, type IdentifierString, type InferSchema, type Instruction, type IsBlockhashValidResponse, KELVIN_PER_RLO, type Kelvin, Keypair, KeypairSigner, Message, type MessageHeader, Mnemonic, type MnemonicStrength, type OptionalAccountInfo, type OwnerAccount, type PDA, PUBLIC_KEY_LENGTH, type PaginationInfo, PublicKey, QueryRpcClient, RIALO_DEVNET_CHAIN, RIALO_LOCALNET_CHAIN, RIALO_MAINNET_CHAIN, RIALO_TESTNET_CHAIN, type RexDuty, type RexInfoAndDuties, RexValue, RexValueVariant, RialoClient, type RialoClientConfig, RialoError, RialoErrorType, type RialoNetwork, RpcError, RpcErrorCode, type RpcErrorDetails$1 as RpcErrorDetails, SECRET_KEY_LENGTH, SECRET_SHARING_HPKE_INFO, SIGNATURE_LENGTH, SYSTEM_PROGRAM_ID, Schema, type SecretSharingPubkey, type Seed, type SendAndConfirmOptions, type SendTransactionOptions, Signature$1 as Signature, type SignatureInfo, type SignatureStatus, type Signer, type StakeAccountInfo, type StakeState, type StructField, type SubmitEpochChangeRequest, type SubmitEpochChangeResponse, type Subscription, type SubscriptionAccountMeta, type SubscriptionInstruction, type SubscriptionKind, SystemInstruction, type TimestampRange, type TokenBalance, Transaction, TransactionBuilder, type TransactionData, TransactionError, TransactionErrorCode, type TransactionInfo, type TransactionMessage, type TransactionNodeData, type TransactionResponse, TransactionRpcClient, type TransactionStatusMetadata, type TransactionWithMeta, type TriggerInfo, type TriggeredTransaction, type TruncationReason, URL_DEVNET, URL_LOCALNET, URL_MAINNET, URL_TESTNET, USER_SECRET_AAD, type ValidatorAccountInfo, type ValidatorHealth, type ValidatorInfoRequest, type WorkflowLineage, type WorkflowNode, X25519_PUBLIC_KEY_LENGTH, allocateInstruction, assignInstruction, calculateBackoff, concatBytes, createAccount, createBorshInstruction, createRialoClient, deserialize, deserializeBorsh, deserializeCompactU16, deserializeStrict, encodeBorshData, encryptForRex, fromBase64, getCiphertextLength, getDefaultRialoClientConfig, getDevnetUrl, getLocalnetUrl, getMainnetUrl, getTestnetUrl, hpkeEncrypt, isOnCurve, isValidCiphertextLength, seedToBytes, serialize, serializeBorsh, serializeCompactU16, sleep, toBase64, transferInstruction, writeCompactU16 };
+/** RISC-V loader program ID (PolkaVM bytecode). */
+declare const RISCV_LOADER_PROGRAM_ID = "RiscVLoader11111111111111111111111111111111";
+/** LoaderV4 program ID (eBPF programs). */
+declare const LOADER_V4_PROGRAM_ID = "LoaderV411111111111111111111111111111111111";
+/** Default chunk size for writing program data (bytes). */
+declare const DEFAULT_CHUNK_SIZE = 3700;
+/** Default max retries when polling for confirmation. */
+declare const DEFAULT_MAX_RETRIES = 350;
+/** Default base delay between retries (ms). */
+declare const DEFAULT_RETRY_BASE_DELAY_MS = 50;
+/** Default max delay between retries (ms). */
+declare const DEFAULT_RETRY_MAX_DELAY_MS = 1000;
+/** Number of chunks to confirm per batch. */
+declare const DEFAULT_CONFIRMATION_BATCH_SIZE = 25;
+/** Safety factor for rent-exempt balance calculation. */
+declare const BUFFER_BALANCE_FACTOR = 1.2;
+/** Byte offset where program data begins in a loader account (size of LoaderState header). */
+declare const PROGRAM_DATA_OFFSET = 48;
+
+interface DeploymentConfig {
+    chunkSize?: number;
+    maxRetries?: number;
+    retryBaseDelayMs?: number;
+    retryMaxDelayMs?: number;
+    confirmationBatchSize?: number;
+}
+interface ProgramDeploymentOptions {
+    programData: Uint8Array;
+    programKeypair: Keypair;
+    config?: DeploymentConfig;
+}
+/**
+ * Deploys PolkaVM programs to Rialo chains.
+ *
+ * Matches the Rust CDK's ProgramDeployment behavior:
+ * 1. Create/prepare program account
+ * 2. Write bytecode in chunks with batched confirmation
+ * 3. Deploy (make executable)
+ */
+declare class ProgramDeployment {
+    private readonly programData;
+    private readonly programKeypair;
+    private readonly chunkSize;
+    private readonly maxRetries;
+    private readonly retryBaseDelayMs;
+    private readonly retryMaxDelayMs;
+    private readonly confirmationBatchSize;
+    constructor(options: ProgramDeploymentOptions);
+    /**
+     * Deploy the program to the blockchain.
+     *
+     * @param client - RPC client
+     * @param payerKeypair - Keypair that pays for transactions and becomes the program authority
+     * @returns The program's public key (derived from programKeypair)
+     */
+    deploy(client: RialoClient, payerKeypair: Keypair): Promise<PublicKey>;
+    private splitIntoChunks;
+    private sendAndConfirm;
+    private confirmBatch;
+    private toDeploymentError;
+    private waitForBufferReady;
+}
+
+/**
+ * Error codes for program deployment operations.
+ */
+declare enum DeploymentErrorCode {
+    EMPTY_PROGRAM_DATA = "EMPTY_PROGRAM_DATA",
+    INVALID_CHUNK_SIZE = "INVALID_CHUNK_SIZE",
+    OWNER_MISMATCH = "OWNER_MISMATCH",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    TRANSACTION_TIMEOUT = "TRANSACTION_TIMEOUT",
+    RPC_ERROR = "RPC_ERROR",
+    BUFFER_NOT_READY = "BUFFER_NOT_READY"
+}
+/**
+ * Error class for program deployment operations with structured error information.
+ */
+declare class DeploymentError extends Error {
+    readonly code: DeploymentErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: DeploymentErrorCode, message: string, details?: Record<string, unknown> | undefined);
+    static emptyProgramData(): DeploymentError;
+    static invalidChunkSize(chunkSize: number): DeploymentError;
+    static ownerMismatch(owner: string): DeploymentError;
+    static transactionFailed(err: string, details?: Record<string, unknown>): DeploymentError;
+    static transactionTimeout(message: string, details?: Record<string, unknown>): DeploymentError;
+    static rpcError(message: string, details?: Record<string, unknown>): DeploymentError;
+    static bufferNotReady(maxRetries: number): DeploymentError;
+    toJSON(): {
+        code: DeploymentErrorCode;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+
+/**
+ * RISC-V loader instruction variant indices.
+ * Must match `RiscVLoaderInstruction` enum order in Rust (bincode u32 encoding).
+ */
+declare enum RiscVLoaderInstruction {
+    Write = 0,
+    Copy = 1,
+    SetProgramLength = 2,
+    Deploy = 3,
+    Retract = 4,
+    TransferAuthority = 5,
+    Finalize = 6
+}
+/**
+ * Create a Write instruction to write bytecode into an undeployed program account.
+ * Accounts: [program (writable), authority (signer)]
+ */
+declare function writeInstruction(programAddress: PublicKey, authority: PublicKey, offset: number, bytes: Uint8Array): Instruction;
+/**
+ * Create a SetProgramLength instruction to resize a program account.
+ * Accounts: [program (writable), authority (signer), recipient (writable)]
+ */
+declare function setProgramLengthInstruction(programAddress: PublicKey, authority: PublicKey, newSize: number, recipientAddress: PublicKey): Instruction;
+/**
+ * Create a Deploy instruction to make a program executable.
+ * Accounts: [program (writable), authority (signer)]
+ */
+declare function deployInstruction(programAddress: PublicKey, authority: PublicKey): Instruction;
+/**
+ * Create a Retract instruction to undo deployment (enters maintenance mode).
+ * Accounts: [program (writable), authority (signer)]
+ */
+declare function retractInstruction(programAddress: PublicKey, authority: PublicKey): Instruction;
+
+export { type AccountFilter, type AccountFilterParam, type AccountInfo, type AccountMeta, AccountMetaTable, type AllAccountsEntry, BASE_DERIVATION_PATH, BUFFER_BALANCE_FACTOR, BaseRpcClient, BincodeReader, type BincodeSchema, BincodeWriter, type BlockInfo, type Bump, CHACHA20_POLY1305_TAG_LENGTH, type ChainDefinition, type ClusterNodeInfo, type CompiledInstruction, type ConfigHashPrefix, type ConfirmTransactionOptions, type ConfirmedTransaction, type ConnectedNode, CryptoError, CryptoErrorCode, DEFAULT_CHUNK_SIZE, DEFAULT_CONFIRMATION_BATCH_SIZE, DEFAULT_MAX_RETRIES, DEFAULT_NUM_ACCOUNTS, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_RETRY_MAX_DELAY_MS, type DeploymentConfig, DeploymentError, DeploymentErrorCode, ED25519_PUBLIC_KEY_LENGTH, type EnumVariant, type EpochConsensusConfigRequest, type EpochInfo, type EventData, type FeeResponse, type GetAccountsByOwnerConfig, type GetAllAccountsConfig, type GetBlockConfig, type GetSignaturesForAddressConfig, type GetTransactionsConfig, type GetValidatorAccountsRequest, type GetWorkflowLineageRequest, type GetWorkflowLineageResponse, HPKE_ENC_LENGTH, HPKE_OVERHEAD_LENGTH, HpkeError, HpkeErrorCode, HttpTransport, type HttpTransportConfig, type IdentifierString, type InferSchema, type Instruction, type IsBlockhashValidResponse, KELVIN_PER_RLO, type Kelvin, Keypair, KeypairSigner, LOADER_V4_PROGRAM_ID, Message, type MessageHeader, Mnemonic, type MnemonicStrength, type OptionalAccountInfo, type OwnerAccount, type PDA, PROGRAM_DATA_OFFSET, PUBLIC_KEY_LENGTH, type PaginationInfo, ProgramDeployment, type ProgramDeploymentOptions, PublicKey, QueryRpcClient, RIALO_DEVNET_CHAIN, RIALO_LOCALNET_CHAIN, RIALO_MAINNET_CHAIN, RIALO_TESTNET_CHAIN, RISCV_LOADER_PROGRAM_ID, type RexDuty, type RexInfoAndDuties, RexValue, RexValueVariant, RialoClient, type RialoClientConfig, RialoError, RialoErrorType, type RialoNetwork, RiscVLoaderInstruction, RpcError, RpcErrorCode, type RpcErrorDetails$1 as RpcErrorDetails, SECRET_KEY_LENGTH, SECRET_SHARING_HPKE_INFO, SIGNATURE_LENGTH, SYSTEM_PROGRAM_ID, Schema, type SecretSharingPubkey, type Seed, type SendAndConfirmOptions, type SendTransactionOptions, Signature$1 as Signature, type SignatureInfo, type SignatureStatus, type Signer, type StakeAccountInfo, type StakeState, type StructField, type SubmitEpochChangeRequest, type SubmitEpochChangeResponse, type Subscription, type SubscriptionAccountMeta, type SubscriptionInstruction, type SubscriptionKind, SystemInstruction, type TimestampRange, type TokenBalance, Transaction, TransactionBuilder, type TransactionData, TransactionError, TransactionErrorCode, type TransactionInfo, type TransactionMessage, type TransactionNodeData, type TransactionResponse, TransactionRpcClient, type TransactionStatusMetadata, type TransactionWithMeta, type TriggerInfo, type TriggeredTransaction, type TruncationReason, URL_DEVNET, URL_LOCALNET, URL_MAINNET, URL_TESTNET, USER_SECRET_AAD, type ValidatorAccountInfo, type ValidatorHealth, type ValidatorInfoRequest, type WorkflowLineage, type WorkflowNode, X25519_PUBLIC_KEY_LENGTH, allocateInstruction, assignInstruction, calculateBackoff, concatBytes, createAccount, createBorshInstruction, createRialoClient, deployInstruction, deserialize, deserializeBorsh, deserializeCompactU16, deserializeStrict, encodeBorshData, encryptForRex, fromBase64, getCiphertextLength, getDefaultRialoClientConfig, getDevnetUrl, getLocalnetUrl, getMainnetUrl, getTestnetUrl, hpkeEncrypt, isOnCurve, isValidCiphertextLength, retractInstruction, seedToBytes, serialize, serializeBorsh, serializeCompactU16, setProgramLengthInstruction, sleep, toBase64, transferInstruction, writeCompactU16, writeInstruction };

package/dist/index.d.ts

@@ -1503,7 +1503,7 @@ interface ValidatorInfoRequest {
     stateSyncAddress: string;
     /** Validator hostname. */
     hostname: string;
-    /** Authority public key. */
+    /** Identity public key. */
     authorityKey: string;
     /** Protocol public key. */
     protocolKey: string;
@@ -1614,6 +1614,8 @@ interface StakeAccountInfo {
     adminAuthority: string;
     /** Withdraw authority (cold wallet, base58). */
     withdrawAuthority: string;
+    /** Optional account that receives rewards instead of compounding (base58). */
+    rewardReceiver?: string;
 }
 /**
  * Request parameters for getValidatorAccounts.
@@ -1630,16 +1632,16 @@ interface ValidatorAccountInfo {
     commission: bigint;
     /** Public key of the validator info account (base58). */
     pubkey: string;
-    /** Node's public key / initial authorized withdrawer (base58). */
-    nodeIdentity: string;
-    /** Authority who can withdraw rewards (base58). */
-    authorizedWithdrawer: string;
-    /** Amount of token staked for next epoch. */
-    stakeNext: bigint;
-    /** Amount of token staked for current epoch (from last frozen snapshot). */
-    stakeCurrent?: bigint;
-    /** Network address for communicating with the validator. */
+    /** Signing key / initial withdrawal key (base58). */
+    signingKey: string;
+    /** Commission withdrawal key (base58). */
+    withdrawalKey: string;
+    /** Aggregate delegated stake for this validator. */
+    stake: bigint;
+    /** Network address for consensus communication. */
     address: string;
+    /** Network address for state synchronization. */
+    stateSyncAddress: string;
 }
 /**
  * SPL Token account balance information.
@@ -4503,4 +4505,134 @@ declare function getMainnetUrl(): string;
  */
 declare function getLocalnetUrl(): string;
 
-export { type AccountFilter, type AccountFilterParam, type AccountInfo, type AccountMeta, AccountMetaTable, type AllAccountsEntry, BASE_DERIVATION_PATH, BaseRpcClient, BincodeReader, type BincodeSchema, BincodeWriter, type BlockInfo, type Bump, CHACHA20_POLY1305_TAG_LENGTH, type ChainDefinition, type ClusterNodeInfo, type CompiledInstruction, type ConfigHashPrefix, type ConfirmTransactionOptions, type ConfirmedTransaction, type ConnectedNode, CryptoError, CryptoErrorCode, DEFAULT_NUM_ACCOUNTS, ED25519_PUBLIC_KEY_LENGTH, type EnumVariant, type EpochConsensusConfigRequest, type EpochInfo, type EventData, type FeeResponse, type GetAccountsByOwnerConfig, type GetAllAccountsConfig, type GetBlockConfig, type GetSignaturesForAddressConfig, type GetTransactionsConfig, type GetValidatorAccountsRequest, type GetWorkflowLineageRequest, type GetWorkflowLineageResponse, HPKE_ENC_LENGTH, HPKE_OVERHEAD_LENGTH, HpkeError, HpkeErrorCode, HttpTransport, type HttpTransportConfig, type IdentifierString, type InferSchema, type Instruction, type IsBlockhashValidResponse, KELVIN_PER_RLO, type Kelvin, Keypair, KeypairSigner, Message, type MessageHeader, Mnemonic, type MnemonicStrength, type OptionalAccountInfo, type OwnerAccount, type PDA, PUBLIC_KEY_LENGTH, type PaginationInfo, PublicKey, QueryRpcClient, RIALO_DEVNET_CHAIN, RIALO_LOCALNET_CHAIN, RIALO_MAINNET_CHAIN, RIALO_TESTNET_CHAIN, type RexDuty, type RexInfoAndDuties, RexValue, RexValueVariant, RialoClient, type RialoClientConfig, RialoError, RialoErrorType, type RialoNetwork, RpcError, RpcErrorCode, type RpcErrorDetails$1 as RpcErrorDetails, SECRET_KEY_LENGTH, SECRET_SHARING_HPKE_INFO, SIGNATURE_LENGTH, SYSTEM_PROGRAM_ID, Schema, type SecretSharingPubkey, type Seed, type SendAndConfirmOptions, type SendTransactionOptions, Signature$1 as Signature, type SignatureInfo, type SignatureStatus, type Signer, type StakeAccountInfo, type StakeState, type StructField, type SubmitEpochChangeRequest, type SubmitEpochChangeResponse, type Subscription, type SubscriptionAccountMeta, type SubscriptionInstruction, type SubscriptionKind, SystemInstruction, type TimestampRange, type TokenBalance, Transaction, TransactionBuilder, type TransactionData, TransactionError, TransactionErrorCode, type TransactionInfo, type TransactionMessage, type TransactionNodeData, type TransactionResponse, TransactionRpcClient, type TransactionStatusMetadata, type TransactionWithMeta, type TriggerInfo, type TriggeredTransaction, type TruncationReason, URL_DEVNET, URL_LOCALNET, URL_MAINNET, URL_TESTNET, USER_SECRET_AAD, type ValidatorAccountInfo, type ValidatorHealth, type ValidatorInfoRequest, type WorkflowLineage, type WorkflowNode, X25519_PUBLIC_KEY_LENGTH, allocateInstruction, assignInstruction, calculateBackoff, concatBytes, createAccount, createBorshInstruction, createRialoClient, deserialize, deserializeBorsh, deserializeCompactU16, deserializeStrict, encodeBorshData, encryptForRex, fromBase64, getCiphertextLength, getDefaultRialoClientConfig, getDevnetUrl, getLocalnetUrl, getMainnetUrl, getTestnetUrl, hpkeEncrypt, isOnCurve, isValidCiphertextLength, seedToBytes, serialize, serializeBorsh, serializeCompactU16, sleep, toBase64, transferInstruction, writeCompactU16 };
+/** RISC-V loader program ID (PolkaVM bytecode). */
+declare const RISCV_LOADER_PROGRAM_ID = "RiscVLoader11111111111111111111111111111111";
+/** LoaderV4 program ID (eBPF programs). */
+declare const LOADER_V4_PROGRAM_ID = "LoaderV411111111111111111111111111111111111";
+/** Default chunk size for writing program data (bytes). */
+declare const DEFAULT_CHUNK_SIZE = 3700;
+/** Default max retries when polling for confirmation. */
+declare const DEFAULT_MAX_RETRIES = 350;
+/** Default base delay between retries (ms). */
+declare const DEFAULT_RETRY_BASE_DELAY_MS = 50;
+/** Default max delay between retries (ms). */
+declare const DEFAULT_RETRY_MAX_DELAY_MS = 1000;
+/** Number of chunks to confirm per batch. */
+declare const DEFAULT_CONFIRMATION_BATCH_SIZE = 25;
+/** Safety factor for rent-exempt balance calculation. */
+declare const BUFFER_BALANCE_FACTOR = 1.2;
+/** Byte offset where program data begins in a loader account (size of LoaderState header). */
+declare const PROGRAM_DATA_OFFSET = 48;
+
+interface DeploymentConfig {
+    chunkSize?: number;
+    maxRetries?: number;
+    retryBaseDelayMs?: number;
+    retryMaxDelayMs?: number;
+    confirmationBatchSize?: number;
+}
+interface ProgramDeploymentOptions {
+    programData: Uint8Array;
+    programKeypair: Keypair;
+    config?: DeploymentConfig;
+}
+/**
+ * Deploys PolkaVM programs to Rialo chains.
+ *
+ * Matches the Rust CDK's ProgramDeployment behavior:
+ * 1. Create/prepare program account
+ * 2. Write bytecode in chunks with batched confirmation
+ * 3. Deploy (make executable)
+ */
+declare class ProgramDeployment {
+    private readonly programData;
+    private readonly programKeypair;
+    private readonly chunkSize;
+    private readonly maxRetries;
+    private readonly retryBaseDelayMs;
+    private readonly retryMaxDelayMs;
+    private readonly confirmationBatchSize;
+    constructor(options: ProgramDeploymentOptions);
+    /**
+     * Deploy the program to the blockchain.
+     *
+     * @param client - RPC client
+     * @param payerKeypair - Keypair that pays for transactions and becomes the program authority
+     * @returns The program's public key (derived from programKeypair)
+     */
+    deploy(client: RialoClient, payerKeypair: Keypair): Promise<PublicKey>;
+    private splitIntoChunks;
+    private sendAndConfirm;
+    private confirmBatch;
+    private toDeploymentError;
+    private waitForBufferReady;
+}
+
+/**
+ * Error codes for program deployment operations.
+ */
+declare enum DeploymentErrorCode {
+    EMPTY_PROGRAM_DATA = "EMPTY_PROGRAM_DATA",
+    INVALID_CHUNK_SIZE = "INVALID_CHUNK_SIZE",
+    OWNER_MISMATCH = "OWNER_MISMATCH",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    TRANSACTION_TIMEOUT = "TRANSACTION_TIMEOUT",
+    RPC_ERROR = "RPC_ERROR",
+    BUFFER_NOT_READY = "BUFFER_NOT_READY"
+}
+/**
+ * Error class for program deployment operations with structured error information.
+ */
+declare class DeploymentError extends Error {
+    readonly code: DeploymentErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: DeploymentErrorCode, message: string, details?: Record<string, unknown> | undefined);
+    static emptyProgramData(): DeploymentError;
+    static invalidChunkSize(chunkSize: number): DeploymentError;
+    static ownerMismatch(owner: string): DeploymentError;
+    static transactionFailed(err: string, details?: Record<string, unknown>): DeploymentError;
+    static transactionTimeout(message: string, details?: Record<string, unknown>): DeploymentError;
+    static rpcError(message: string, details?: Record<string, unknown>): DeploymentError;
+    static bufferNotReady(maxRetries: number): DeploymentError;
+    toJSON(): {
+        code: DeploymentErrorCode;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+
+/**
+ * RISC-V loader instruction variant indices.
+ * Must match `RiscVLoaderInstruction` enum order in Rust (bincode u32 encoding).
+ */
+declare enum RiscVLoaderInstruction {
+    Write = 0,
+    Copy = 1,
+    SetProgramLength = 2,
+    Deploy = 3,
+    Retract = 4,
+    TransferAuthority = 5,
+    Finalize = 6
+}
+/**
+ * Create a Write instruction to write bytecode into an undeployed program account.
+ * Accounts: [program (writable), authority (signer)]
+ */
+declare function writeInstruction(programAddress: PublicKey, authority: PublicKey, offset: number, bytes: Uint8Array): Instruction;
+/**
+ * Create a SetProgramLength instruction to resize a program account.
+ * Accounts: [program (writable), authority (signer), recipient (writable)]
+ */
+declare function setProgramLengthInstruction(programAddress: PublicKey, authority: PublicKey, newSize: number, recipientAddress: PublicKey): Instruction;
+/**
+ * Create a Deploy instruction to make a program executable.
+ * Accounts: [program (writable), authority (signer)]
+ */
+declare function deployInstruction(programAddress: PublicKey, authority: PublicKey): Instruction;
+/**
+ * Create a Retract instruction to undo deployment (enters maintenance mode).
+ * Accounts: [program (writable), authority (signer)]
+ */
+declare function retractInstruction(programAddress: PublicKey, authority: PublicKey): Instruction;
+
+export { type AccountFilter, type AccountFilterParam, type AccountInfo, type AccountMeta, AccountMetaTable, type AllAccountsEntry, BASE_DERIVATION_PATH, BUFFER_BALANCE_FACTOR, BaseRpcClient, BincodeReader, type BincodeSchema, BincodeWriter, type BlockInfo, type Bump, CHACHA20_POLY1305_TAG_LENGTH, type ChainDefinition, type ClusterNodeInfo, type CompiledInstruction, type ConfigHashPrefix, type ConfirmTransactionOptions, type ConfirmedTransaction, type ConnectedNode, CryptoError, CryptoErrorCode, DEFAULT_CHUNK_SIZE, DEFAULT_CONFIRMATION_BATCH_SIZE, DEFAULT_MAX_RETRIES, DEFAULT_NUM_ACCOUNTS, DEFAULT_RETRY_BASE_DELAY_MS, DEFAULT_RETRY_MAX_DELAY_MS, type DeploymentConfig, DeploymentError, DeploymentErrorCode, ED25519_PUBLIC_KEY_LENGTH, type EnumVariant, type EpochConsensusConfigRequest, type EpochInfo, type EventData, type FeeResponse, type GetAccountsByOwnerConfig, type GetAllAccountsConfig, type GetBlockConfig, type GetSignaturesForAddressConfig, type GetTransactionsConfig, type GetValidatorAccountsRequest, type GetWorkflowLineageRequest, type GetWorkflowLineageResponse, HPKE_ENC_LENGTH, HPKE_OVERHEAD_LENGTH, HpkeError, HpkeErrorCode, HttpTransport, type HttpTransportConfig, type IdentifierString, type InferSchema, type Instruction, type IsBlockhashValidResponse, KELVIN_PER_RLO, type Kelvin, Keypair, KeypairSigner, LOADER_V4_PROGRAM_ID, Message, type MessageHeader, Mnemonic, type MnemonicStrength, type OptionalAccountInfo, type OwnerAccount, type PDA, PROGRAM_DATA_OFFSET, PUBLIC_KEY_LENGTH, type PaginationInfo, ProgramDeployment, type ProgramDeploymentOptions, PublicKey, QueryRpcClient, RIALO_DEVNET_CHAIN, RIALO_LOCALNET_CHAIN, RIALO_MAINNET_CHAIN, RIALO_TESTNET_CHAIN, RISCV_LOADER_PROGRAM_ID, type RexDuty, type RexInfoAndDuties, RexValue, RexValueVariant, RialoClient, type RialoClientConfig, RialoError, RialoErrorType, type RialoNetwork, RiscVLoaderInstruction, RpcError, RpcErrorCode, type RpcErrorDetails$1 as RpcErrorDetails, SECRET_KEY_LENGTH, SECRET_SHARING_HPKE_INFO, SIGNATURE_LENGTH, SYSTEM_PROGRAM_ID, Schema, type SecretSharingPubkey, type Seed, type SendAndConfirmOptions, type SendTransactionOptions, Signature$1 as Signature, type SignatureInfo, type SignatureStatus, type Signer, type StakeAccountInfo, type StakeState, type StructField, type SubmitEpochChangeRequest, type SubmitEpochChangeResponse, type Subscription, type SubscriptionAccountMeta, type SubscriptionInstruction, type SubscriptionKind, SystemInstruction, type TimestampRange, type TokenBalance, Transaction, TransactionBuilder, type TransactionData, TransactionError, TransactionErrorCode, type TransactionInfo, type TransactionMessage, type TransactionNodeData, type TransactionResponse, TransactionRpcClient, type TransactionStatusMetadata, type TransactionWithMeta, type TriggerInfo, type TriggeredTransaction, type TruncationReason, URL_DEVNET, URL_LOCALNET, URL_MAINNET, URL_TESTNET, USER_SECRET_AAD, type ValidatorAccountInfo, type ValidatorHealth, type ValidatorInfoRequest, type WorkflowLineage, type WorkflowNode, X25519_PUBLIC_KEY_LENGTH, allocateInstruction, assignInstruction, calculateBackoff, concatBytes, createAccount, createBorshInstruction, createRialoClient, deployInstruction, deserialize, deserializeBorsh, deserializeCompactU16, deserializeStrict, encodeBorshData, encryptForRex, fromBase64, getCiphertextLength, getDefaultRialoClientConfig, getDevnetUrl, getLocalnetUrl, getMainnetUrl, getTestnetUrl, hpkeEncrypt, isOnCurve, isValidCiphertextLength, retractInstruction, seedToBytes, serialize, serializeBorsh, serializeCompactU16, setProgramLengthInstruction, sleep, toBase64, transferInstruction, writeCompactU16, writeInstruction };