@hsuite/smart-engines-sdk 3.7.0 → 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

@@ -2164,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 = {
@@ -4249,6 +4249,7 @@ export type BaasInitResponse = {
 		repository: string;
 	};
 };
+export type BaasReissuePushCredentialsResponse = BaasInitResponse;
 export type BaasDeployRequest = {
 	tag: string;
 	port?: number;
@@ -4319,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>;
@@ -5507,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[];
 	};
@@ -25151,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;
@@ -25221,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>;
@@ -25261,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;
@@ -25272,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;
@@ -25488,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 };