feat: add signature context

* update types

* update version

* fix types

---------

Co-authored-by: Aliaksei <milutkin.work@gmail.com>

Author: alexlexan

package.json

@@ -1,6 +1,6 @@
 {
   "name": "everscale-inpage-provider",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "description": "Web3-like interface to the Everscale blockchain",
   "repository": "https://github.com/broxus/everscale-inpage-provider",
   "main": "dist/index.js",

src/api.ts

@@ -21,6 +21,7 @@ import {
   AddNetwork,
   IgnoreTransactionTreeSimulationError,
   GetterCall,
+  SignatureContext,
 } from './models';
 
 import { UniqueArray, Address } from './utils';
@@ -1163,8 +1164,32 @@ export type ProviderApi<Addr = Address> = {
        * - If `true`, uses the signature id of the selected network (if the capability is enabled).
        * - If `false`, forces signature check to ignore any signature id.
        * - If `number`, uses the specified number as a signature id.
+       * @deprecated
+       * Use `signatureCtx` instead.
        */
       withSignatureId?: boolean | number;
+
+      /**
+       * Optional advanced signature configuration.
+       *
+       * In most cases you **do not need to set this manually**.
+       * The wallet or network configuration will choose the correct mode.
+       *
+       * This field controls how the data is prepared before signing:
+       *
+       * - `empty` — signs the data as-is.
+       *   Use for simple or legacy signing.
+       *
+       * - `signatureId` — signs the data together with a network-specific id.
+       *   Prevents signatures from being reused on another network.
+       *
+       * - `signatureDomain` — uses a domain-separated signature mode.
+       *   This is the most secure and modern option.
+       *
+       *
+       * If provided, this field overrides `withSignatureId`.
+       */
+      withSignatureContext?: SignatureContext;
     };
     output: {
       /**
@@ -1279,8 +1304,32 @@ export type ProviderApi<Addr = Address> = {
        * - If `true`, uses the signature id of the selected network (if the capability is enabled).
        * - If `false`, forces signature check to ignore any signature id.
        * - If `number`, uses the specified number as a signature id.
+       * @deprecated
+       * Use `signatureCtx` instead.
        */
       withSignatureId?: boolean | number;
+
+      /**
+       * Optional advanced signature configuration.
+       *
+       * In most cases you **do not need to set this manually**.
+       * The wallet or network configuration will choose the correct mode.
+       *
+       * This field controls how the data is prepared before signing:
+       *
+       * - `empty` — signs the data as-is.
+       *   Use for simple or legacy signing.
+       *
+       * - `signatureId` — signs the data together with a network-specific id.
+       *   Prevents signatures from being reused on another network.
+       *
+       * - `signatureDomain` — uses a domain-separated signature mode.
+       *   This is the most secure and modern option.
+       *
+       *
+       * If provided, this field overrides `withSignatureId`.
+       */
+      withSignatureContext?: SignatureContext;
     };
     output: {
       /**
@@ -1333,8 +1382,32 @@ export type ProviderApi<Addr = Address> = {
        * - If `true`, uses the signature id of the selected network (if the capability is enabled).
        * - If `false`, forces signature check to ignore any signature id.
        * - If `number`, uses the specified number as a signature id.
+       * @deprecated
+       * Use `signatureCtx` instead.
        */
       withSignatureId?: boolean | number;
+
+      /**
+       * Optional advanced signature configuration.
+       *
+       * In most cases you **do not need to set this manually**.
+       * The wallet or network configuration will choose the correct mode.
+       *
+       * This field controls how the data is prepared before signing:
+       *
+       * - `empty` — signs the data as-is.
+       *   Use for simple or legacy signing.
+       *
+       * - `signatureId` — signs the data together with a network-specific id.
+       *   Prevents signatures from being reused on another network.
+       *
+       * - `signatureDomain` — uses a domain-separated signature mode.
+       *   This is the most secure and modern option.
+       *
+       *
+       * If provided, this field overrides `withSignatureId`.
+       */
+      withSignatureContext?: SignatureContext;
     };
     output: {
       /**
@@ -1677,7 +1750,7 @@ export type ProviderApi<Addr = Address> = {
       switchNetwork?: boolean;
     };
     output: {
-      network: Network | null
+      network: Network | null;
     };
   };
 

src/models.ts

@@ -321,8 +321,17 @@ export type NetworkDescription = {
   globalId: number;
   capabilities: string;
   signatureId: number | undefined;
+  signatureCtx: SignatureContext;
 };
 
+/**
+ * @category Models
+ */
+export type SignatureContext =
+  | { type: 'empty' } // ton/legacy networks
+  | { type: 'signatureId'; globalId: number } // simple prefix
+  | { type: 'signatureDomainL2'; globalId: number }; // full domain prefix
+
 /**
  * @category Models
  */
@@ -340,19 +349,19 @@ export type GqlSocketParams = {
   /**
    * Path to graphql api endpoints
    */
-  endpoints: string[]
+  endpoints: string[];
   /**
    * Frequency of sync latency detection
    */
-  latencyDetectionInterval: number
+  latencyDetectionInterval: number;
   /**
    * Maximum value for the endpoint's blockchain data sync latency
    */
-  maxLatency: number
+  maxLatency: number;
   /**
    * Gql node type
    */
-  local: boolean
+  local: boolean;
 };
 
 /**
@@ -362,17 +371,17 @@ export type JrpcSocketParams = {
   /**
    * Path to jrpc api endpoint
    */
-  endpoint: string
+  endpoint: string;
 };
 
 /**
  * @category Models
  */
 export type ProtoSocketParams = JrpcSocketParams & {};
 
-export type GqlConnection = { type: 'graphql', data: GqlSocketParams };
-export type JrpcConnection = { type: 'jrpc', data: JrpcSocketParams };
-export type ProtoConnection = { type: 'proto', data: ProtoSocketParams };
+export type GqlConnection = { type: 'graphql'; data: GqlSocketParams };
+export type JrpcConnection = { type: 'jrpc'; data: JrpcSocketParams };
+export type ProtoConnection = { type: 'proto'; data: ProtoSocketParams };
 
 /**
  * @category Models
@@ -743,21 +752,21 @@ export type OutputTokenObject<O> = O extends { name: infer K; type: infer T; com
 export type MergeInputObjectsArray<A> = A extends readonly [infer T, ...infer Ts]
   ? InputTokenObject<T> & MergeInputObjectsArray<[...Ts]>
   : A extends readonly [infer T]
-  ? InputTokenObject<T>
-  : A extends readonly []
-  ? {}
-  : never;
+    ? InputTokenObject<T>
+    : A extends readonly []
+      ? {}
+      : never;
 
 /**
  * @category Models
  */
 export type MergeOutputObjectsArray<A> = A extends readonly [infer T, ...infer Ts]
   ? OutputTokenObject<T> & MergeOutputObjectsArray<[...Ts]>
   : A extends readonly [infer T]
-  ? OutputTokenObject<T>
-  : A extends readonly []
-  ? {}
-  : never;
+    ? OutputTokenObject<T>
+    : A extends readonly []
+      ? {}
+      : never;
 
 /**
  * @category Models
@@ -857,19 +866,14 @@ export type AbiGetterInputs<C, T extends AbiGetterName<C>> = MergeInputObjectsAr
 /**
  * @category Models
  */
-export type AbiGetterInputsWithDefault<C, T extends AbiGetterName<C>> = AbiGetter<
-  C,
-  T
->['inputs'] extends readonly []
+export type AbiGetterInputsWithDefault<C, T extends AbiGetterName<C>> = AbiGetter<C, T>['inputs'] extends readonly []
   ? void | Record<string, never>
   : AbiGetterInputs<C, T>;
 
 /**
  * @category Models
  */
-export type DecodedAbiGetterInputs<C, T extends AbiGetterName<C>> = MergeOutputObjectsArray<
-  AbiGetter<C, T>['inputs']
->;
+export type DecodedAbiGetterInputs<C, T extends AbiGetterName<C>> = MergeOutputObjectsArray<AbiGetter<C, T>['inputs']>;
 /**
  * @category Models
  */