@hsuite/smart-engines-sdk 3.6.1 → 3.10.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 3.8.0 — 2026-06-17
+
+### Added
+
+- **`BaasClient` now exposes `transactions` (prepare/execute), validator-routed.** The host-routed `BaasClient` gains a `transactions` arm (`TransactionsClient`) so showcase/CLI consumers can drive the sovereignty prepare/execute flow without constructing a separate `SmartEngineClient`. It targets the validator's `/api/transactions/*` routes — a sibling of the `/host` BaaS surface, rooted at the raw gateway/ingress origin (`hostUrl`), NOT under the `pathPrefix`. The prepare endpoints accept an explicit `payerAccountId` (session-less payer) OR carry the web3-auth session token for the JWT-wallet payer path; the token is kept in lock-step with the main client's via `authenticate` / `reauthenticate` / `logout`.
+
 ## 3.6.1 — 2026-06-15
 
 ### Fixed

package/README.md

@@ -54,7 +54,7 @@ await baas.authenticate({
   },
 });
 
-// 4. Initialise a free_testnet smart-app via the four-step deploy flow
+// 4. Initialise a smart-app via the four-step deploy flow
 //    (init → docker push → optional uploadFrontend → deploy). `init` runs
 //    the per-entity DKG ceremony on the cluster and returns the DKG entityId
 //    as `appId`, plus ephemeral push credentials for the cluster's per-tenant

package/dist/index.d.ts

@@ -487,6 +487,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",
@@ -511,6 +535,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";
@@ -524,6 +572,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;
@@ -536,6 +590,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<{
@@ -694,6 +754,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;
@@ -716,6 +800,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;
@@ -738,6 +828,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>;
@@ -2068,7 +2164,7 @@ export type Web3Signer = {
 	wallet: Wallet;
 };
 export declare function createXrplWeb3Signer(seed: string): Web3Signer;
-export type SubscriptionTierName = "free_testnet" | "starter" | "professional" | "enterprise";
+export type SubscriptionTierName = "builder" | "growth" | "scale" | "enterprise";
 export type SubscriptionStatus = "pending_deposit" | "deposit_confirmed" | "active" | "expired" | "cancelled";
 export type DepositWalletStatus = "pending" | "locked" | "expired" | "slashed" | "released";
 export type SubscriptionTierInfo = {
@@ -2591,6 +2687,8 @@ export type PrepareTransferRequest = {
 	securityMode?: SecurityMode;
 	appOwnerPublicKey?: string;
 	ss58Format?: number;
+	ruleRef?: RuleRefInput;
+	entityType?: string;
 };
 export type PrepareNftMintRequest = {
 	chain: ChainType;
@@ -3818,6 +3916,22 @@ export 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 declare function canonicalizeAttestation(att: BuildAttestation): string;
+export declare function computeAttestationHash(att: BuildAttestation): string;
+export declare function signAttestation(att: BuildAttestation, xrplSeed: string): string;
+export declare function verifyAttestation(att: BuildAttestation, signature: string, walletAddress: string): boolean;
 export type BaasService = "auth" | "database" | "storage" | "functions" | "messaging";
 export type BaasSupportedChain = "hedera" | "xrpl" | "polkadot" | "solana";
 export type BaasEndpoints = {
@@ -4135,6 +4249,7 @@ export type BaasInitResponse = {
 		repository: string;
 	};
 };
+export type BaasReissuePushCredentialsResponse = BaasInitResponse;
 export type BaasDeployRequest = {
 	tag: string;
 	port?: number;
@@ -4146,6 +4261,10 @@ export type BaasDeployRequest = {
 		memory?: string;
 	};
 	strategy?: "rolling" | "recreate";
+	attestation?: {
+		payload: BuildAttestation;
+		signature: string;
+	};
 };
 export type BaasDeployResponse = {
 	appId: string;
@@ -4201,6 +4320,8 @@ export declare class DeploymentClient {
 	private readonly http;
 	constructor(http: HttpClient);
 	init(request: BaasInitRequest): Promise<BaasInitResponse>;
+	pushCredentials(appId: string): Promise<BaasInitResponse>;
+	reissuePushCredentials(appId: string): Promise<BaasReissuePushCredentialsResponse>;
 	uploadFrontend(appId: string, bundle: Blob | Buffer, filename?: string): Promise<BaasUploadFrontendResponse>;
 	deploy(appId: string, request: BaasDeployRequest): Promise<BaasDeployResponse>;
 	rollback(appId: string, request: BaasRollbackRequest): Promise<BaasDeployResponse>;
@@ -5389,7 +5510,7 @@ export type CustomerSessionInfo = {
 	customerAddress: string;
 	subscriptionContext?: {
 		nftSerial: number;
-		tier: "free_testnet" | "starter" | "professional" | "enterprise";
+		tier: "builder" | "growth" | "scale" | "enterprise";
 		expiresAt: string;
 		allowedAutomations?: string[];
 	};
@@ -25033,17 +25154,40 @@ type CreateTokenRequest$1 = {
 	initialSupply?: string;
 	ruleRef: RuleRef;
 	memo?: string;
+	securityMode?: EntitySecurityMode;
+	payerAccountId?: string;
+	fundWith?: FundWith;
 };
+export type EntitySecurityMode = "partial" | "full";
+export type PreparedEntityCreation = {
+	entityId: string;
+	chain: ChainType;
+	address: string;
+	reserveRequirement: string;
+	prepared: PreparedTransaction[];
+};
+export type FundWith = (prepared: PreparedTransaction[], ctx: {
+	address: string;
+	reserveRequirement: string;
+}) => Promise<{
+	signedFundingBlob?: string;
+} | void>;
 type CreateAccountRequest$1 = {
 	chain: ChainType;
 	ruleRef: RuleRef;
 	initialBalance?: string;
 	publicKey?: string;
+	securityMode?: EntitySecurityMode;
+	payerAccountId?: string;
+	fundWith?: FundWith;
 };
 export type CreateTopicRequest = {
 	chain: ChainType;
 	ruleRef: RuleRef;
 	memo?: string;
+	securityMode?: EntitySecurityMode;
+	payerAccountId?: string;
+	fundWith?: FundWith;
 };
 export type CreateAgentRequest = {
 	primaryChain: ChainType;
@@ -25103,8 +25247,34 @@ export type LaunchpadEntityResult = {
 export declare class EntitiesClient {
 	private readonly http;
 	constructor(http: HttpClient);
+	private static readonly PAYER_FUNDED_TOKEN_CHAINS;
+	prepareCreateToken(req: Omit<CreateTokenRequest$1, "fundWith">): Promise<PreparedEntityCreation>;
+	executeCreateToken(req: {
+		entityId: string;
+		chain: ChainType;
+		securityMode?: EntitySecurityMode;
+		createTxId?: string;
+		signedFundingBlob?: string;
+	}): Promise<EntityCreationResult>;
 	createToken(req: CreateTokenRequest$1): Promise<EntityCreationResult>;
+	prepareCreateAccount(req: Omit<CreateAccountRequest$1, "fundWith">): Promise<PreparedEntityCreation>;
+	executeCreateAccount(req: {
+		entityId: string;
+		chain: ChainType;
+		securityMode?: EntitySecurityMode;
+		signedFundingBlob?: string;
+		createTxId?: string;
+	}): Promise<EntityCreationResult>;
+	private static readonly PAYER_FUNDED_CREATE_CHAINS;
+	private static readonly FUNDING_BLOB_RELAY_CHAINS;
 	createAccount(req: CreateAccountRequest$1): Promise<EntityCreationResult>;
+	prepareCreateTopic(req: Omit<CreateTopicRequest, "fundWith">): Promise<PreparedEntityCreation>;
+	executeCreateTopic(req: {
+		entityId: string;
+		chain: ChainType;
+		createTxId: string;
+		securityMode?: EntitySecurityMode;
+	}): Promise<EntityCreationResult>;
 	createTopic(req: CreateTopicRequest): Promise<EntityCreationResult>;
 	createAgent(req: CreateAgentRequest): Promise<EntityCreationResult>;
 	launchpad(req: LaunchpadEntityRequest): Promise<LaunchpadEntityResult>;
@@ -25143,6 +25313,7 @@ export declare class BaasClient {
 	private readonly timeout;
 	private readonly allowInsecure;
 	private readonly http;
+	private readonly txHttp;
 	private lastHttpError?;
 	private authContext?;
 	readonly db: DatabaseClient;
@@ -25154,6 +25325,7 @@ export declare class BaasClient {
 	readonly customerSession: CustomerSessionClient;
 	readonly rules: RulesClient;
 	readonly entities: EntitiesClient;
+	readonly transactions: TransactionsClient;
 	constructor(config: BaasClientConfig);
 	static connectToCluster(config: BaasConnectToClusterConfig): Promise<BaasClient>;
 	setAppId(appId: string): void;
@@ -25370,7 +25542,7 @@ declare namespace personhood {
 	export { PERSONHOOD_VERIFIER_NOT_CONFIGURED, PersonhoodAttestationMethod, PersonhoodCert, PersonhoodClient, PersonhoodProof, PersonhoodVerifyParams, isPersonhoodVerifierNotConfigured };
 }
 declare namespace baas {
-	export { AgentBalance, AgentEvent, AgentFundRequest, AgentInfo, AgentOperation, AgentRegisterRequest, AgentRules, AgentRulesValidationResult, AgentStatus, AgentTradeRequest, AgentWithdrawRequest, AgentsClient, AuthenticateOptions, BaasAppListResponse, BaasAuthConfig, BaasAuthResult, BaasChallengeRequest, BaasChallengeResponse, BaasChannelConfig, BaasClient, BaasClientConfig, BaasConnectToClusterConfig, BaasDeleteResult, BaasDeployRequest, BaasDeployResponse, BaasDocument, BaasEndpoints, BaasError, BaasErrorDetails, BaasErrorResponse, BaasFileInfo, BaasFileMetadata, BaasFindResult, BaasFunctionDeployRequest, BaasFunctionDeployResult, BaasFunctionInfo, BaasFunctionLog, BaasFunctionLogOptions, BaasFunctionResources, BaasFunctionResult, BaasFunctionRuntime, BaasHistoryOptions, BaasInitRequest, BaasInitResponse, BaasInsertResult, BaasMerkleProof, BaasMessage, BaasPresenceInfo, BaasPresenceMember, BaasPublishResult, BaasQueryOptions, BaasRevokeKekResponse, BaasRollbackRequest, BaasRotateKekResponse, BaasRuntimeStatus, BaasService, BaasSessionInfo, BaasSetWebhookResponse, BaasStateTransition, BaasStorageUsage, BaasSupportedChain, BaasTriggerType, BaasUpdateResult, BaasUploadFrontendResponse, BaasUploadResult, BaasVerifyRequest, ChannelSubscription, CreateAccountRequest$1 as BaasCreateAccountRequest, CreateAgentRequest, CreateTokenRequest$1 as CreateTokenRequest, CreateTopicRequest, DatabaseClient, DatabaseStatsResponse, DbComparisonOperator, DbDocument, DbQuery, DeployedApp, DeployedAppInfo, DeployedAppLimits, DeployedAppStatus, DeployedAppUsage, DeploymentClient, DeprecateRuleResponse, DocumentProofResponse, EntitiesClient, EntityCreationResult, EntityInfo, EntityType$1 as BaasEntityType, FunctionsClient, LaunchpadEntityRequest, LaunchpadEntityResult, ListEntitiesFilter, ListEntitiesResponse, ListRulesFilter, ListRulesResponse, MessageHandler, MessagingClient, PublishRuleResponse, RulesClient, SimulateRuleRequest, StateRootResponse, StateTransitionsResponse, StorageClient, ValidationResult, VersionHistoryResponse, validateAgentRules };
+	export { AgentBalance, AgentEvent, AgentFundRequest, AgentInfo, AgentOperation, AgentRegisterRequest, AgentRules, AgentRulesValidationResult, AgentStatus, AgentTradeRequest, AgentWithdrawRequest, AgentsClient, AuthenticateOptions, BaasAppListResponse, BaasAuthConfig, BaasAuthResult, BaasChallengeRequest, BaasChallengeResponse, BaasChannelConfig, BaasClient, BaasClientConfig, BaasConnectToClusterConfig, BaasDeleteResult, BaasDeployRequest, BaasDeployResponse, BaasDocument, BaasEndpoints, BaasError, BaasErrorDetails, BaasErrorResponse, BaasFileInfo, BaasFileMetadata, BaasFindResult, BaasFunctionDeployRequest, BaasFunctionDeployResult, BaasFunctionInfo, BaasFunctionLog, BaasFunctionLogOptions, BaasFunctionResources, BaasFunctionResult, BaasFunctionRuntime, BaasHistoryOptions, BaasInitRequest, BaasInitResponse, BaasInsertResult, BaasMerkleProof, BaasMessage, BaasPresenceInfo, BaasPresenceMember, BaasPublishResult, BaasQueryOptions, BaasReissuePushCredentialsResponse, BaasRevokeKekResponse, BaasRollbackRequest, BaasRotateKekResponse, BaasRuntimeStatus, BaasService, BaasSessionInfo, BaasSetWebhookResponse, BaasStateTransition, BaasStorageUsage, BaasSupportedChain, BaasTriggerType, BaasUpdateResult, BaasUploadFrontendResponse, BaasUploadResult, BaasVerifyRequest, ChannelSubscription, CreateAccountRequest$1 as BaasCreateAccountRequest, CreateAgentRequest, CreateTokenRequest$1 as CreateTokenRequest, CreateTopicRequest, DatabaseClient, DatabaseStatsResponse, DbComparisonOperator, DbDocument, DbQuery, DeployedApp, DeployedAppInfo, DeployedAppLimits, DeployedAppStatus, DeployedAppUsage, DeploymentClient, DeprecateRuleResponse, DocumentProofResponse, EntitiesClient, EntityCreationResult, EntityInfo, EntitySecurityMode, EntityType$1 as BaasEntityType, FunctionsClient, FundWith, LaunchpadEntityRequest, LaunchpadEntityResult, ListEntitiesFilter, ListEntitiesResponse, ListRulesFilter, ListRulesResponse, MessageHandler, MessagingClient, PreparedEntityCreation, PublishRuleResponse, RulesClient, SimulateRuleRequest, StateRootResponse, StateTransitionsResponse, StorageClient, ValidationResult, VersionHistoryResponse, validateAgentRules };
 }
 declare namespace pqcVerify {
 	export { FetchRegistryOptions, PqcCertV1, PqcCertV1Schema, PqcCertV1Signer, ValidatorRegistrySnapshot, VerifyResult, fetchRegistrySnapshot, parsePqcCert, verifyPqcAttestation };