@solana/web3.js 1.41.1 → 1.41.4

package/lib/index.d.ts

@@ -527,6 +527,7 @@ declare module '@solana/web3.js' {
     static populate(message: Message, signatures?: Array<string>): Transaction;
   }
 
+  export type ClientSubscriptionId = number;
   export type TokenAccountsFilter =
     | {
         mint: PublicKey;
@@ -2001,13 +2002,15 @@ declare module '@solana/web3.js' {
       publicKey: PublicKey,
       callback: AccountChangeCallback,
       commitment?: Commitment,
-    ): number;
+    ): ClientSubscriptionId;
     /**
      * Deregister an account notification callback
      *
-     * @param id subscription id to deregister
+     * @param id client subscription id to deregister
      */
-    removeAccountChangeListener(id: number): Promise<void>;
+    removeAccountChangeListener(
+      clientSubscriptionId: ClientSubscriptionId,
+    ): Promise<void>;
     /**
      * Register a callback to be invoked whenever accounts owned by the
      * specified program change
@@ -2023,13 +2026,15 @@ declare module '@solana/web3.js' {
       callback: ProgramAccountChangeCallback,
       commitment?: Commitment,
       filters?: GetProgramAccountsFilter[],
-    ): number;
+    ): ClientSubscriptionId;
     /**
      * Deregister an account notification callback
      *
-     * @param id subscription id to deregister
+     * @param id client subscription id to deregister
      */
-    removeProgramAccountChangeListener(id: number): Promise<void>;
+    removeProgramAccountChangeListener(
+      clientSubscriptionId: ClientSubscriptionId,
+    ): Promise<void>;
     /**
      * Registers a callback to be invoked whenever logs are emitted.
      */
@@ -2037,26 +2042,30 @@ declare module '@solana/web3.js' {
       filter: LogsFilter,
       callback: LogsCallback,
       commitment?: Commitment,
-    ): number;
+    ): ClientSubscriptionId;
     /**
      * Deregister a logs callback.
      *
-     * @param id subscription id to deregister.
+     * @param id client subscription id to deregister.
      */
-    removeOnLogsListener(id: number): Promise<void>;
+    removeOnLogsListener(
+      clientSubscriptionId: ClientSubscriptionId,
+    ): Promise<void>;
     /**
      * Register a callback to be invoked upon slot changes
      *
      * @param callback Function to invoke whenever the slot changes
      * @return subscription id
      */
-    onSlotChange(callback: SlotChangeCallback): number;
+    onSlotChange(callback: SlotChangeCallback): ClientSubscriptionId;
     /**
      * Deregister a slot notification callback
      *
-     * @param id subscription id to deregister
+     * @param id client subscription id to deregister
      */
-    removeSlotChangeListener(id: number): Promise<void>;
+    removeSlotChangeListener(
+      clientSubscriptionId: ClientSubscriptionId,
+    ): Promise<void>;
     /**
      * Register a callback to be invoked upon slot updates. {@link SlotUpdate}'s
      * may be useful to track live progress of a cluster.
@@ -2064,13 +2073,15 @@ declare module '@solana/web3.js' {
      * @param callback Function to invoke whenever the slot updates
      * @return subscription id
      */
-    onSlotUpdate(callback: SlotUpdateCallback): number;
+    onSlotUpdate(callback: SlotUpdateCallback): ClientSubscriptionId;
     /**
      * Deregister a slot update notification callback
      *
-     * @param id subscription id to deregister
+     * @param id client subscription id to deregister
      */
-    removeSlotUpdateListener(id: number): Promise<void>;
+    removeSlotUpdateListener(
+      clientSubscriptionId: ClientSubscriptionId,
+    ): Promise<void>;
     _buildArgs(
       args: Array<any>,
       override?: Commitment,
@@ -2089,7 +2100,7 @@ declare module '@solana/web3.js' {
       signature: TransactionSignature,
       callback: SignatureResultCallback,
       commitment?: Commitment,
-    ): number;
+    ): ClientSubscriptionId;
     /**
      * Register a callback to be invoked when a transaction is
      * received and/or processed.
@@ -2104,26 +2115,30 @@ declare module '@solana/web3.js' {
       signature: TransactionSignature,
       callback: SignatureSubscriptionCallback,
       options?: SignatureSubscriptionOptions,
-    ): number;
+    ): ClientSubscriptionId;
     /**
      * Deregister a signature notification callback
      *
-     * @param id subscription id to deregister
+     * @param id client subscription id to deregister
      */
-    removeSignatureListener(id: number): Promise<void>;
+    removeSignatureListener(
+      clientSubscriptionId: ClientSubscriptionId,
+    ): Promise<void>;
     /**
      * Register a callback to be invoked upon root changes
      *
      * @param callback Function to invoke whenever the root changes
      * @return subscription id
      */
-    onRootChange(callback: RootChangeCallback): number;
+    onRootChange(callback: RootChangeCallback): ClientSubscriptionId;
     /**
      * Deregister a root notification callback
      *
-     * @param id subscription id to deregister
+     * @param id client subscription id to deregister
      */
-    removeRootChangeListener(id: number): Promise<void>;
+    removeRootChangeListener(
+      clientSubscriptionId: ClientSubscriptionId,
+    ): Promise<void>;
   }
 
   export const BPF_LOADER_PROGRAM_ID: PublicKey;
@@ -2617,7 +2632,7 @@ declare module '@solana/web3.js' {
     /** Account that will receive transferred lamports */
     toPubkey: PublicKey;
     /** Amount of lamports to transfer */
-    lamports: number;
+    lamports: number | bigint;
   };
   /**
    * Assign system transaction params
@@ -2767,7 +2782,31 @@ declare module '@solana/web3.js' {
     /** Account that will receive transferred lamports */
     toPubkey: PublicKey;
     /** Amount of lamports to transfer */
-    lamports: number;
+    lamports: number | bigint;
+    /** Seed to use to derive the funding account address */
+    seed: string;
+    /** Program id to use to derive the funding account address */
+    programId: PublicKey;
+  };
+  /** Decoded transfer system transaction instruction */
+  export type DecodedTransferInstruction = {
+    /** Account that will transfer lamports */
+    fromPubkey: PublicKey;
+    /** Account that will receive transferred lamports */
+    toPubkey: PublicKey;
+    /** Amount of lamports to transfer */
+    lamports: bigint;
+  };
+  /** Decoded transferWithSeed system transaction instruction */
+  export type DecodedTransferWithSeedInstruction = {
+    /** Account that will transfer lamports */
+    fromPubkey: PublicKey;
+    /** Base public key to use to derive the funding account address */
+    basePubkey: PublicKey;
+    /** Account that will receive transferred lamports */
+    toPubkey: PublicKey;
+    /** Amount of lamports to transfer */
+    lamports: bigint;
     /** Seed to use to derive the funding account address */
     seed: string;
     /** Program id to use to derive the funding account address */
@@ -2792,13 +2831,15 @@ declare module '@solana/web3.js' {
     /**
      * Decode a transfer system instruction and retrieve the instruction params.
      */
-    static decodeTransfer(instruction: TransactionInstruction): TransferParams;
+    static decodeTransfer(
+      instruction: TransactionInstruction,
+    ): DecodedTransferInstruction;
     /**
      * Decode a transfer with seed system instruction and retrieve the instruction params.
      */
     static decodeTransferWithSeed(
       instruction: TransactionInstruction,
-    ): TransferWithSeedParams;
+    ): DecodedTransferWithSeedInstruction;
     /**
      * Decode an allocate system instruction and retrieve the instruction params.
      */
@@ -2993,6 +3034,16 @@ declare module '@solana/web3.js' {
     ): TransactionInstruction;
   }
 
+  /**
+   * Maximum over-the-wire size of a Transaction
+   *
+   * 1280 is IPv6 minimum MTU
+   * 40 bytes is the size of the IPv6 header
+   * 8 bytes is the size of the fragment header
+   */
+  export const PACKET_DATA_SIZE: number;
+  export const SIGNATURE_LENGTH_IN_BYTES = 64;
+
   export const VALIDATOR_INFO_KEY: PublicKey;
   /**
    * Info used to identity validators.