@hsuite/smart-engines-sdk 3.6.0 → 3.7.0

package/dist/nestjs/index.d.ts

@@ -255,6 +255,30 @@ declare const TokenInfoSchema: z.ZodObject<{
 	circulatingSupply?: string | undefined;
 }>;
 export type TokenInfo = z.infer<typeof TokenInfoSchema>;
+declare const RuleRefSchema: z.ZodObject<{
+	chain: z.ZodEnum<[
+		"hedera",
+		"xrpl",
+		"polkadot",
+		"solana",
+		"stellar",
+		"ethereum",
+		"polygon",
+		"bitcoin",
+		"cardano"
+	]>;
+	topicId: z.ZodString;
+	consensusTimestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+	chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+	topicId: string;
+	consensusTimestamp: string;
+}, {
+	chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+	topicId: string;
+	consensusTimestamp: string;
+}>;
+export type RuleRefInput = z.infer<typeof RuleRefSchema>;
 declare const CreateAccountRequestSchema: z.ZodObject<{
 	chain: z.ZodEnum<[
 		"hedera",
@@ -279,6 +303,30 @@ declare const CreateAccountRequestSchema: z.ZodObject<{
 		"full"
 	]>>;
 	appOwnerPublicKey: z.ZodOptional<z.ZodString>;
+	ruleRef: z.ZodOptional<z.ZodObject<{
+		chain: z.ZodEnum<[
+			"hedera",
+			"xrpl",
+			"polkadot",
+			"solana",
+			"stellar",
+			"ethereum",
+			"polygon",
+			"bitcoin",
+			"cardano"
+		]>;
+		topicId: z.ZodString;
+		consensusTimestamp: z.ZodString;
+	}, "strip", z.ZodTypeAny, {
+		chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+		topicId: string;
+		consensusTimestamp: string;
+	}, {
+		chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+		topicId: string;
+		consensusTimestamp: string;
+	}>>;
+	entityType: z.ZodOptional<z.ZodString>;
 	metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, "strip", z.ZodTypeAny, {
 	chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
@@ -292,6 +340,12 @@ declare const CreateAccountRequestSchema: z.ZodObject<{
 	appOwnerPublicKey?: string | undefined;
 	memo?: string | undefined;
 	payerAccountId?: string | undefined;
+	ruleRef?: {
+		chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+		topicId: string;
+		consensusTimestamp: string;
+	} | undefined;
+	entityType?: string | undefined;
 }, {
 	chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
 	initialBalance: string;
@@ -304,6 +358,12 @@ declare const CreateAccountRequestSchema: z.ZodObject<{
 	memo?: string | undefined;
 	payerAccountId?: string | undefined;
 	immutable?: boolean | undefined;
+	ruleRef?: {
+		chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+		topicId: string;
+		consensusTimestamp: string;
+	} | undefined;
+	entityType?: string | undefined;
 }>;
 export type CreateAccountRequest = z.infer<typeof CreateAccountRequestSchema>;
 declare const CreateAccountResponseSchema: z.ZodObject<{
@@ -462,6 +522,30 @@ declare const CreateTokenRequestSchema: z.ZodObject<{
 	validatorTopicId: z.ZodString;
 	immutable: z.ZodDefault<z.ZodBoolean>;
 	payerAccountId: z.ZodOptional<z.ZodString>;
+	ruleRef: z.ZodOptional<z.ZodObject<{
+		chain: z.ZodEnum<[
+			"hedera",
+			"xrpl",
+			"polkadot",
+			"solana",
+			"stellar",
+			"ethereum",
+			"polygon",
+			"bitcoin",
+			"cardano"
+		]>;
+		topicId: z.ZodString;
+		consensusTimestamp: z.ZodString;
+	}, "strip", z.ZodTypeAny, {
+		chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+		topicId: string;
+		consensusTimestamp: string;
+	}, {
+		chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+		topicId: string;
+		consensusTimestamp: string;
+	}>>;
+	entityType: z.ZodOptional<z.ZodString>;
 	metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
 }, "strip", z.ZodTypeAny, {
 	symbol: string;
@@ -484,6 +568,12 @@ declare const CreateTokenRequestSchema: z.ZodObject<{
 	initialSupply: string;
 	metadata?: Record<string, any> | undefined;
 	payerAccountId?: string | undefined;
+	ruleRef?: {
+		chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+		topicId: string;
+		consensusTimestamp: string;
+	} | undefined;
+	entityType?: string | undefined;
 	treasury?: string | undefined;
 }, {
 	symbol: string;
@@ -506,6 +596,12 @@ declare const CreateTokenRequestSchema: z.ZodObject<{
 	metadata?: Record<string, any> | undefined;
 	payerAccountId?: string | undefined;
 	immutable?: boolean | undefined;
+	ruleRef?: {
+		chain: "hedera" | "xrpl" | "polkadot" | "solana" | "stellar" | "ethereum" | "polygon" | "bitcoin" | "cardano";
+		topicId: string;
+		consensusTimestamp: string;
+	} | undefined;
+	entityType?: string | undefined;
 	treasury?: string | undefined;
 }>;
 export type CreateTokenRequest = z.infer<typeof CreateTokenRequestSchema>;
@@ -2148,6 +2244,8 @@ export type PrepareTransferRequest = {
 	securityMode?: SecurityMode;
 	appOwnerPublicKey?: string;
 	ss58Format?: number;
+	ruleRef?: RuleRefInput;
+	entityType?: string;
 };
 export type PrepareNftMintRequest = {
 	chain: ChainType;
@@ -3341,6 +3439,18 @@ declare class AgentsClient {
 		success: boolean;
 	}>;
 }
+export type BuildAttestation = {
+	readonly version: "1";
+	readonly appId: string;
+	readonly developerWallet: string;
+	readonly developerChain: ChainType;
+	readonly framework: "ionic" | "nestjs";
+	readonly sdkVersion: string;
+	readonly imageDigest: string;
+	readonly bundleSha256: string;
+	readonly cliVersion: string;
+	readonly builtAt: number;
+};
 export type BaasService = "auth" | "database" | "storage" | "functions" | "messaging";
 export type BaasSupportedChain = "hedera" | "xrpl" | "polkadot" | "solana";
 export type BaasEndpoints = {
@@ -3598,6 +3708,10 @@ export type BaasDeployRequest = {
 		memory?: string;
 	};
 	strategy?: "rolling" | "recreate";
+	attestation?: {
+		payload: BuildAttestation;
+		signature: string;
+	};
 };
 export type BaasDeployResponse = {
 	appId: string;

package/dist/nestjs/index.js

@@ -199,6 +199,14 @@ var PreparedTransactionSovereigntySchema = zod.z.discriminatedUnion("mode", [
     authorizationSet: PreparedTransactionAuthorizationSetSchema.optional()
   })
 ]);
+var RuleRefSchema = zod.z.object({
+  /** Chain whose HCS the rule was published on (canonically 'hedera'). */
+  chain: ChainTypeSchema,
+  /** HCS topic ID the rule message was published to. */
+  topicId: zod.z.string().min(1),
+  /** HCS consensus timestamp of the rule message. */
+  consensusTimestamp: zod.z.string().min(1)
+});
 var CreateAccountRequestSchema = zod.z.object({
   chain: ChainTypeSchema,
   initialBalance: zod.z.string(),
@@ -238,6 +246,22 @@ var CreateAccountRequestSchema = zod.z.object({
    * The owner key + TSS network key form a threshold-2 multi-sig.
    */
   appOwnerPublicKey: zod.z.string().optional(),
+  /**
+   * The entity's canonical `ruleRef` (HCS pointer to its `ValidatorRules`). When
+   * present, the chain adapter stamps the IMMUTABLE creation-tx rule anchor
+   * (`rule:<topicId>@<consensusTimestamp>:<entityType>`) — distinct from the
+   * mutable validator-binding memo — so the sign-gate resolves the rule on-chain
+   * (kind:'ref') rather than trusting the replicated binding
+   * (RFC 2026-06-15-onchain-rule-anchor §6.1). Absent ⇒ the degraded
+   * `rule:bootstrap:<entityType>` marker when `entityType` is supplied.
+   */
+  ruleRef: RuleRefSchema.optional(),
+  /**
+   * Entity-type tag stamped into the rule anchor (e.g. 'wallet', 'account').
+   * Supply it to enable the on-chain anchor; omit for the prior memo-less
+   * (legacy) behaviour.
+   */
+  entityType: zod.z.string().min(1).optional(),
   metadata: zod.z.record(zod.z.any()).optional()
 });
 zod.z.object({
@@ -325,6 +349,21 @@ var CreateTokenRequestSchema = zod.z.object({
   immutable: zod.z.boolean().default(true),
   /** See CreateAccountRequestSchema.payerAccountId — same resolution rules. */
   payerAccountId: zod.z.string().optional(),
+  /**
+   * The entity's canonical `ruleRef` (HCS pointer to its `ValidatorRules`). When
+   * present, the chain adapter stamps the IMMUTABLE creation-tx rule anchor
+   * (`rule:<topicId>@<consensusTimestamp>:<entityType>`) — distinct from the
+   * mutable validator-binding token memo — so the sign-gate resolves the rule
+   * on-chain (kind:'ref') rather than trusting the replicated binding
+   * (RFC 2026-06-15-onchain-rule-anchor §6.1). Absent ⇒ the degraded
+   * `rule:bootstrap:<entityType>` marker when `entityType` is supplied.
+   */
+  ruleRef: RuleRefSchema.optional(),
+  /**
+   * Entity-type tag stamped into the rule anchor (e.g. 'token'). Supply it to
+   * enable the on-chain anchor; omit for the prior memo-less behaviour.
+   */
+  entityType: zod.z.string().min(1).optional(),
   metadata: zod.z.record(zod.z.any()).optional()
 });
 zod.z.object({
@@ -4065,11 +4104,28 @@ var SmartGatewayClient = class {
     return this.http.get("/status");
   }
   /**
-   * Check gateway readiness. Returns either `{ status: 'ready', ... }` with
-   * a verified host count or `{ status: 'not_ready', reason, ... }`.
+   * Check gateway readiness. Resolves to either `{ status: 'ready', ... }`
+   * with a verified host count or `{ status: 'not_ready', reason, ... }`.
+   *
+   * NOTE: `/api/v3/ready` returns **HTTP 503** when not ready (so load
+   * balancers / k8s probes drain the origin). This method unwraps that 503's
+   * body and still RESOLVES to a `GatewayReadinessResponse` — it does not
+   * throw for a not-ready gateway. Genuine errors (non-readiness 503s, 5xx,
+   * network) still throw.
    */
   async getReadiness() {
-    return this.http.get("/ready");
+    try {
+      return await this.http.get("/ready");
+    } catch (err) {
+      if (err instanceof SdkHttpError && err.statusCode === 503) {
+        const d = err.details;
+        const body = d?.context ?? d;
+        if (body?.status === "not_ready") {
+          return body;
+        }
+      }
+      throw err;
+    }
   }
   /** Check gateway liveness. */
   async getLiveness() {