@thru/programs 0.2.25 → 0.2.28

package/dist/multicall/index.d.cts

@@ -2,12 +2,13 @@ type __TnValidateResult$1 = {
     ok: boolean;
     code?: string;
     consumed?: bigint;
+    params?: Record<string, bigint>;
 };
-type __TnBuilderLike = {
+type __TnBuilderLike$1 = {
     build(): Uint8Array;
 };
 type __TnFamWriterResult<Parent> = {
-    write(payload: Uint8Array | __TnBuilderLike): {
+    write(payload: Uint8Array | __TnBuilderLike$1): {
         finish(): Parent;
     };
     finish(): Parent;
@@ -124,6 +125,17 @@ type __TnValidateResult = {
     ok: boolean;
     code?: string;
     consumed?: bigint;
+    params?: Record<string, bigint>;
+};
+type __TnBuilderLike = {
+    build(): Uint8Array;
+};
+type __TnStructFieldInput = Uint8Array | __TnBuilderLike | {
+    buffer?: Uint8Array;
+} | {
+    asUint8Array?: () => Uint8Array;
+} | {
+    bytes?: () => Uint8Array;
 };
 declare class MulticallArgs {
     private buffer;
@@ -138,6 +150,8 @@ declare class MulticallArgs {
     dynamicParams(): MulticallArgs.Params;
     withFieldContext(context: Record<string, number | bigint>): this;
     private __tnResolveFieldRef;
+    static builder(): MulticallArgsBuilder;
+    static fromBuilder(builder: MulticallArgsBuilder): MulticallArgs | null;
     private static __tnExtractParams;
     get_calls_count(): number;
     set_calls_count(value: number): void;
@@ -203,6 +217,28 @@ declare namespace MulticallArgs {
         calls_calls_count: number | bigint;
     }): Params;
 }
+declare class MulticallArgsBuilder {
+    private buffer;
+    private view;
+    private __tnJagged_calls;
+    private __tnCachedParams;
+    private __tnLastBuffer;
+    private __tnLastParams;
+    constructor();
+    private __tnInvalidate;
+    set_calls_count(value: number): this;
+    set_calls(values: readonly (InstructionData | __TnStructFieldInput)[]): this;
+    build(): Uint8Array;
+    buildInto(target: Uint8Array, offset?: number): Uint8Array;
+    finish(): MulticallArgs;
+    finishView(): MulticallArgs;
+    dynamicParams(): MulticallArgs.Params;
+    private __tnComputeParams;
+    private __tnCollectFragments;
+    private __tnComputeSize;
+    private __tnWriteInto;
+    private __tnValidateOrThrow;
+}
 declare class MulticallError {
     private buffer;
     private view;
@@ -250,4 +286,4 @@ declare const MULTICALL_PROGRAM_PUBKEY: Uint8Array<ArrayBuffer>;
 declare const MULTICALL_PROGRAM_ADDRESS: string;
 declare function buildMulticallInstruction(calls: MulticallCall[]): Uint8Array;
 
-export { InstructionData, InstructionDataBuilder, MULTICALL_PROGRAM_ADDRESS, MULTICALL_PROGRAM_PUBKEY, MulticallArgs, type MulticallCall, MulticallError, buildMulticallInstruction };
+export { InstructionData, InstructionDataBuilder, MULTICALL_PROGRAM_ADDRESS, MULTICALL_PROGRAM_PUBKEY, MulticallArgs, MulticallArgsBuilder, type MulticallCall, MulticallError, buildMulticallInstruction };

package/dist/multicall/index.d.ts

@@ -2,12 +2,13 @@ type __TnValidateResult$1 = {
     ok: boolean;
     code?: string;
     consumed?: bigint;
+    params?: Record<string, bigint>;
 };
-type __TnBuilderLike = {
+type __TnBuilderLike$1 = {
     build(): Uint8Array;
 };
 type __TnFamWriterResult<Parent> = {
-    write(payload: Uint8Array | __TnBuilderLike): {
+    write(payload: Uint8Array | __TnBuilderLike$1): {
         finish(): Parent;
     };
     finish(): Parent;
@@ -124,6 +125,17 @@ type __TnValidateResult = {
     ok: boolean;
     code?: string;
     consumed?: bigint;
+    params?: Record<string, bigint>;
+};
+type __TnBuilderLike = {
+    build(): Uint8Array;
+};
+type __TnStructFieldInput = Uint8Array | __TnBuilderLike | {
+    buffer?: Uint8Array;
+} | {
+    asUint8Array?: () => Uint8Array;
+} | {
+    bytes?: () => Uint8Array;
 };
 declare class MulticallArgs {
     private buffer;
@@ -138,6 +150,8 @@ declare class MulticallArgs {
     dynamicParams(): MulticallArgs.Params;
     withFieldContext(context: Record<string, number | bigint>): this;
     private __tnResolveFieldRef;
+    static builder(): MulticallArgsBuilder;
+    static fromBuilder(builder: MulticallArgsBuilder): MulticallArgs | null;
     private static __tnExtractParams;
     get_calls_count(): number;
     set_calls_count(value: number): void;
@@ -203,6 +217,28 @@ declare namespace MulticallArgs {
         calls_calls_count: number | bigint;
     }): Params;
 }
+declare class MulticallArgsBuilder {
+    private buffer;
+    private view;
+    private __tnJagged_calls;
+    private __tnCachedParams;
+    private __tnLastBuffer;
+    private __tnLastParams;
+    constructor();
+    private __tnInvalidate;
+    set_calls_count(value: number): this;
+    set_calls(values: readonly (InstructionData | __TnStructFieldInput)[]): this;
+    build(): Uint8Array;
+    buildInto(target: Uint8Array, offset?: number): Uint8Array;
+    finish(): MulticallArgs;
+    finishView(): MulticallArgs;
+    dynamicParams(): MulticallArgs.Params;
+    private __tnComputeParams;
+    private __tnCollectFragments;
+    private __tnComputeSize;
+    private __tnWriteInto;
+    private __tnValidateOrThrow;
+}
 declare class MulticallError {
     private buffer;
     private view;
@@ -250,4 +286,4 @@ declare const MULTICALL_PROGRAM_PUBKEY: Uint8Array<ArrayBuffer>;
 declare const MULTICALL_PROGRAM_ADDRESS: string;
 declare function buildMulticallInstruction(calls: MulticallCall[]): Uint8Array;
 
-export { InstructionData, InstructionDataBuilder, MULTICALL_PROGRAM_ADDRESS, MULTICALL_PROGRAM_PUBKEY, MulticallArgs, type MulticallCall, MulticallError, buildMulticallInstruction };
+export { InstructionData, InstructionDataBuilder, MULTICALL_PROGRAM_ADDRESS, MULTICALL_PROGRAM_PUBKEY, MulticallArgs, MulticallArgsBuilder, type MulticallCall, MulticallError, buildMulticallInstruction };

package/dist/multicall/index.js

@@ -621,7 +621,8 @@ __tnRegisterFootprint("Date", (params) => Date.__tnInvokeFootprint(params));
 __tnRegisterValidate("Date", (buffer, params) => Date.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate("Date", (buffer) => {
   const result = Date.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed), params };
 });
 var __tn_ir_Duration = {
   typeName: "Duration",
@@ -749,7 +750,8 @@ __tnRegisterFootprint("Duration", (params) => Duration.__tnInvokeFootprint(param
 __tnRegisterValidate("Duration", (buffer, params) => Duration.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate("Duration", (buffer) => {
   const result = Duration.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed), params };
 });
 var __tn_ir_FixedPoint = {
   typeName: "FixedPoint",
@@ -877,7 +879,8 @@ __tnRegisterFootprint("FixedPoint", (params) => FixedPoint.__tnInvokeFootprint(p
 __tnRegisterValidate("FixedPoint", (buffer, params) => FixedPoint.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate("FixedPoint", (buffer) => {
   const result = FixedPoint.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed), params };
 });
 var __tn_ir_Hash = {
   typeName: "Hash",
@@ -992,7 +995,8 @@ __tnRegisterFootprint("Hash", (params) => Hash.__tnInvokeFootprint(params));
 __tnRegisterValidate("Hash", (buffer, params) => Hash.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate("Hash", (buffer) => {
   const result = Hash.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed), params };
 });
 var __tn_ir_InstructionData = {
   typeName: "InstructionData",
@@ -1332,7 +1336,8 @@ __tnRegisterFootprint("InstructionData", (params) => InstructionData.__tnInvokeF
 __tnRegisterValidate("InstructionData", (buffer, params) => InstructionData.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate("InstructionData", (buffer) => {
   const result = InstructionData.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed), params };
 });
 var __tn_ir_Pubkey = {
   typeName: "Pubkey",
@@ -1447,7 +1452,8 @@ __tnRegisterFootprint("Pubkey", (params) => Pubkey.__tnInvokeFootprint(params));
 __tnRegisterValidate("Pubkey", (buffer, params) => Pubkey.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate("Pubkey", (buffer) => {
   const result = Pubkey.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed), params };
 });
 var __tn_ir_Signature = {
   typeName: "Signature",
@@ -1562,7 +1568,8 @@ __tnRegisterFootprint("Signature", (params) => Signature.__tnInvokeFootprint(par
 __tnRegisterValidate("Signature", (buffer, params) => Signature.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate("Signature", (buffer) => {
   const result = Signature.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed), params };
 });
 var __tn_ir_Timestamp = {
   typeName: "Timestamp",
@@ -1671,7 +1678,8 @@ __tnRegisterFootprint("Timestamp", (params) => Timestamp.__tnInvokeFootprint(par
 __tnRegisterValidate("Timestamp", (buffer, params) => Timestamp.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate("Timestamp", (buffer) => {
   const result = Timestamp.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt(result.consumed), params };
 });
 
 // src/multicall/abi/thru/program/multicall/types.ts
@@ -1690,6 +1698,36 @@ function __tnWarnOnce2(message) {
     __tnLogWarn2(message);
   }
 }
+function __tnResolveBuilderInput2(input, context) {
+  if (input instanceof Uint8Array) {
+    return new Uint8Array(input);
+  }
+  if (input && typeof input.build === "function") {
+    const built = input.build();
+    if (!(built instanceof Uint8Array)) {
+      throw new Error(`${context}: builder did not return Uint8Array`);
+    }
+    return new Uint8Array(built);
+  }
+  throw new Error(`${context}: expected Uint8Array or builder`);
+}
+function __tnResolveStructFieldInput(input, context) {
+  if (input instanceof Uint8Array || input && typeof input.build === "function") {
+    return __tnResolveBuilderInput2(input, context);
+  }
+  if (input && typeof input.asUint8Array === "function") {
+    const bytes = input.asUint8Array();
+    return new Uint8Array(bytes);
+  }
+  if (input && typeof input.bytes === "function") {
+    const bytes = input.bytes();
+    return new Uint8Array(bytes);
+  }
+  if (input && input.buffer instanceof Uint8Array) {
+    return new Uint8Array(input.buffer);
+  }
+  throw new Error(`${context}: expected Uint8Array, builder, or view-like value`);
+}
 var __tnMask322 = __tnHasNativeBigInt2 ? (BigInt(1) << BigInt(32)) - BigInt(1) : 4294967295;
 var __tnSignBit322 = __tnHasNativeBigInt2 ? BigInt(1) << BigInt(31) : 2147483648;
 function __tnToBigInt2(value) {
@@ -2113,7 +2151,8 @@ __tnRegisterFootprint2("InstructionData", (params) => InstructionData.__tnInvoke
 __tnRegisterValidate2("InstructionData", (buffer, params) => InstructionData.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate2("InstructionData", (buffer) => {
   const result = InstructionData.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt2(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt2(result.consumed), params };
 });
 var __tn_ir_MulticallArgs = {
   typeName: "MulticallArgs",
@@ -2167,6 +2206,14 @@ var MulticallArgs = class _MulticallArgs {
     }
     throw new Error("MulticallArgs: field reference '" + path + "' is not available; provide fieldContext when creating this view");
   }
+  static builder() {
+    return new MulticallArgsBuilder();
+  }
+  static fromBuilder(builder) {
+    const buffer = builder.build();
+    const params = builder.dynamicParams();
+    return _MulticallArgs.from_array(buffer, { params });
+  }
   static __tnExtractParams(view, buffer) {
     if (buffer.length < 2) {
       return null;
@@ -2370,11 +2417,116 @@ var MulticallArgs = class _MulticallArgs {
   }
   MulticallArgs2.params = params;
 })(MulticallArgs || (MulticallArgs = {}));
+var MulticallArgsBuilder = class {
+  constructor() {
+    this.__tnJagged_calls = null;
+    this.__tnCachedParams = null;
+    this.__tnLastBuffer = null;
+    this.__tnLastParams = null;
+    this.buffer = new Uint8Array(2);
+    this.view = new DataView(this.buffer.buffer, this.buffer.byteOffset, this.buffer.byteLength);
+  }
+  __tnInvalidate() {
+    this.__tnCachedParams = null;
+    this.__tnLastBuffer = null;
+    this.__tnLastParams = null;
+  }
+  set_calls_count(value) {
+    this.view.setUint16(0, value, true);
+    this.__tnInvalidate();
+    return this;
+  }
+  set_calls(values) {
+    const fragments = [];
+    for (let i = 0; i < values.length; i++) {
+      const bytes = __tnResolveStructFieldInput(values[i], "MulticallArgsBuilder::calls[" + i + "]");
+      const validation = __tnInvokeDynamicValidate2("InstructionData", bytes);
+      if (!validation.ok || validation.consumed === void 0) throw new Error("MulticallArgsBuilder: field 'calls' element failed validation");
+      if (__tnBigIntToNumber2(validation.consumed, "MulticallArgsBuilder::calls") !== bytes.length) throw new Error("MulticallArgsBuilder: field 'calls' element validation did not consume the full buffer");
+      fragments.push(bytes);
+    }
+    this.__tnJagged_calls = fragments;
+    this.set_calls_count(fragments.length);
+    this.__tnInvalidate();
+    return this;
+  }
+  build() {
+    const params = this.__tnComputeParams();
+    const fragments = this.__tnCollectFragments();
+    const size = this.__tnComputeSize(fragments);
+    const buffer = new Uint8Array(size);
+    this.__tnWriteInto(buffer, fragments);
+    this.__tnValidateOrThrow(buffer, params);
+    return buffer;
+  }
+  buildInto(target, offset = 0) {
+    const params = this.__tnComputeParams();
+    const fragments = this.__tnCollectFragments();
+    const size = this.__tnComputeSize(fragments);
+    if (target.length - offset < size) throw new Error("MulticallArgsBuilder: target buffer too small");
+    const slice = target.subarray(offset, offset + size);
+    this.__tnWriteInto(slice, fragments);
+    this.__tnValidateOrThrow(slice, params);
+    return target;
+  }
+  finish() {
+    const buffer = this.build();
+    const params = this.__tnLastParams ?? this.__tnComputeParams();
+    const view = MulticallArgs.from_array(buffer, { params });
+    if (!view) throw new Error("MulticallArgsBuilder: failed to finalize view");
+    return view;
+  }
+  finishView() {
+    return this.finish();
+  }
+  dynamicParams() {
+    return this.__tnComputeParams();
+  }
+  __tnComputeParams() {
+    if (this.__tnCachedParams) return this.__tnCachedParams;
+    const params = MulticallArgs.Params.fromValues({
+      calls_calls_count: (() => {
+        const fragments = this.__tnJagged_calls;
+        if (!fragments) throw new Error("MulticallArgsBuilder: field 'calls' must be written before computing params");
+        return __tnToBigInt2(fragments.length);
+      })()
+    });
+    this.__tnCachedParams = params;
+    return params;
+  }
+  __tnCollectFragments() {
+    const fragments = this.__tnJagged_calls;
+    if (!fragments) throw new Error("MulticallArgsBuilder: field 'calls' must be written before build");
+    return fragments;
+  }
+  __tnComputeSize(fragments) {
+    let total = this.buffer.length;
+    for (const fragment of fragments) total += fragment.length;
+    return total;
+  }
+  __tnWriteInto(target, fragments) {
+    target.set(this.buffer, 0);
+    let cursor = this.buffer.length;
+    for (const fragment of fragments) {
+      target.set(fragment, cursor);
+      cursor += fragment.length;
+    }
+  }
+  __tnValidateOrThrow(buffer, params) {
+    const result = MulticallArgs.validate(buffer, { params });
+    if (!result.ok) {
+      throw new Error(`${MulticallArgs}Builder: builder produced invalid buffer (code=${result.code ?? "unknown"})`);
+    }
+    this.__tnLastParams = result.params ?? params;
+    this.__tnLastBuffer = buffer;
+  }
+};
 __tnRegisterFootprint2("MulticallArgs", (params) => MulticallArgs.__tnInvokeFootprint(params));
 __tnRegisterValidate2("MulticallArgs", (buffer, params) => MulticallArgs.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate2("MulticallArgs", (buffer) => {
   const result = MulticallArgs.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt2(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt2(result.consumed), params };
 });
 var __tn_ir_MulticallError = {
   typeName: "MulticallError",
@@ -2483,7 +2635,8 @@ __tnRegisterFootprint2("MulticallError", (params) => MulticallError.__tnInvokeFo
 __tnRegisterValidate2("MulticallError", (buffer, params) => MulticallError.__tnInvokeValidate(buffer, params));
 __tnRegisterDynamicValidate2("MulticallError", (buffer) => {
   const result = MulticallError.validate(buffer);
-  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt2(result.consumed) };
+  const params = result.params;
+  return { ok: result.ok, code: result.code, consumed: result.consumed === void 0 ? void 0 : __tnToBigInt2(result.consumed), params };
 });
 
 // src/multicall/index.ts
@@ -2522,10 +2675,6 @@ var MULTICALL_PROGRAM_PUBKEY = new Uint8Array([
   9
 ]);
 var MULTICALL_PROGRAM_ADDRESS = encodeAddress(MULTICALL_PROGRAM_PUBKEY);
-function writeU16LE(target, offset, value) {
-  target[offset] = value & 255;
-  target[offset + 1] = value >> 8 & 255;
-}
 function assertProgramIdx(programIdx) {
   if (!Number.isInteger(programIdx) || programIdx < 0 || programIdx > 65535) {
     throw new Error("programIdx must be 0-65535");
@@ -2550,15 +2699,7 @@ function buildMulticallInstruction(calls) {
   if (!Array.isArray(calls)) throw new Error("calls must be an array");
   if (calls.length > 65535) throw new Error("calls length must be 0-65535");
   const encodedCalls = calls.map(buildInstructionData);
-  const totalLength = 2 + encodedCalls.reduce((sum, call) => sum + call.length, 0);
-  const output = new Uint8Array(totalLength);
-  let offset = 0;
-  writeU16LE(output, offset, calls.length);
-  offset += 2;
-  for (const call of encodedCalls) {
-    output.set(call, offset);
-    offset += call.length;
-  }
+  const output = new MulticallArgsBuilder().set_calls(encodedCalls).build();
   const validation = MulticallArgs.validate(output);
   if (!validation.ok || validation.consumed !== output.length) {
     throw new Error(
@@ -2568,6 +2709,6 @@ function buildMulticallInstruction(calls) {
   return output;
 }
 
-export { InstructionData, InstructionDataBuilder, MULTICALL_PROGRAM_ADDRESS, MULTICALL_PROGRAM_PUBKEY, MulticallArgs, MulticallError, buildMulticallInstruction };
+export { InstructionData, InstructionDataBuilder, MULTICALL_PROGRAM_ADDRESS, MULTICALL_PROGRAM_PUBKEY, MulticallArgs, MulticallArgsBuilder, MulticallError, buildMulticallInstruction };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map