@hsuite/smart-engines-sdk 3.0.2 → 3.1.0

package/dist/nestjs/index.d.ts

@@ -683,6 +683,19 @@ export interface ValidatorInfo {
 	registeredAt: string;
 	messageType?: "validator.join" | "validator.leave" | "validator.update";
 }
+export interface ClusterEndpointsView {
+	clusterId: string;
+	gatewayUrl: string;
+	harborUrl?: string;
+	natsUrl?: string;
+	publicIp?: string;
+	region?: string;
+}
+export interface ClusterInfo {
+	clusterId: string;
+	endpoints: ClusterEndpointsView;
+	nodeIds: string[];
+}
 export type AuthChain = "hedera" | "xrpl" | "polkadot" | "stellar" | "solana";
 export interface AuthenticateResponse {
 	token: string;
@@ -710,7 +723,7 @@ export type HttpClient = {
 	get<T = any>(path: string): Promise<T>;
 	put<T = any>(path: string, body: unknown): Promise<T>;
 	delete<T = any>(path: string): Promise<T>;
-	upload<T = any>(path: string, file: Blob | Buffer, filename: string, metadata?: Record<string, string>): Promise<T>;
+	upload<T = any>(path: string, file: Blob | Buffer, filename: string, metadata?: Record<string, string>, fieldName?: string): Promise<T>;
 };
 export type SubscriptionTierName = "free_testnet" | "starter" | "professional" | "enterprise";
 export type SubscriptionStatus = "pending_deposit" | "deposit_confirmed" | "active" | "expired" | "cancelled";
@@ -839,7 +852,6 @@ export type EntityCreationResponse = {
 	success: boolean;
 	entityId: string;
 	publicKeys: string[];
-	signerIndices: number[];
 	threshold: number;
 	ceremonyIds: string[];
 };
@@ -859,7 +871,6 @@ export type ReshareResponse = {
 export type EntityDetails = {
 	success: boolean;
 	payload?: unknown;
-	signerIndices?: number[];
 	validators?: string[];
 	publicKeys?: string[];
 	error?: string;
@@ -1213,6 +1224,43 @@ declare class SnapshotsClient {
 	listByToken(tokenId: string, pagination?: PaginationOptions): Promise<SnapshotListResponse>;
 	download(snapshotId: string, format?: SnapshotFormat): Promise<any>;
 }
+export type HistoricalBalanceChain = "hedera" | "xrpl" | "polkadot";
+export type HistoricalBalanceQueryParams = {
+	chain: HistoricalBalanceChain;
+	entityId: string;
+	account: string;
+	atTimestamp: number;
+};
+export type HistoricalBalanceResult = {
+	chain: HistoricalBalanceChain;
+	entityId: string;
+	account: string;
+	atTimestamp: number;
+	balance: string;
+	source: "archive";
+};
+export type HistoricalBalanceClientConfig = {
+	baseUrl: string;
+	authToken?: string;
+	apiKey?: string;
+	timeoutMs?: number;
+	fetchImpl?: typeof fetch;
+};
+declare class HistoricalBalanceClient {
+	private readonly baseUrl?;
+	private readonly authToken?;
+	private readonly apiKey?;
+	private readonly timeoutMs;
+	private readonly fetchImpl?;
+	private readonly http?;
+	constructor(config: HistoricalBalanceClientConfig | {
+		http: HttpClient;
+	});
+	static fromHttp(http: HttpClient): HistoricalBalanceClient;
+	getBalance(params: HistoricalBalanceQueryParams): Promise<HistoricalBalanceResult>;
+	private validateParams;
+	private standaloneFetch;
+}
 export type SettlementPurpose = "subscription" | "deposit" | "fee";
 export type SettlementAsset = {
 	symbol: string;
@@ -1254,6 +1302,115 @@ declare class SettlementClient {
 	confirmXrpLanded(settlementId: string): Promise<SettlementStatusResponse>;
 	getHistory(entityId: string): Promise<SettlementHistoryEntry[]>;
 }
+export type GovernanceVotingPowerMethod = "token_balance" | "quadratic" | "one_person_one_vote" | "nft_based" | "time_weighted" | "delegated";
+export type GovernanceProposalStatus = "pending" | "active" | "passed" | "failed" | "executed" | "cancelled" | "expired" | "vetoed";
+export type GovernanceVoteType = "for" | "against" | "abstain";
+export interface GovernanceProposalData {
+	proposalId: string;
+	proposer: string;
+	title: string;
+	description: string;
+	actions: unknown[];
+	status: GovernanceProposalStatus;
+	createdAt: string | Date;
+	votingStartsAt: string | Date;
+	votingEndsAt: string | Date;
+	executionDeadline?: string | Date;
+	votes: {
+		for: string;
+		against: string;
+		abstain: string;
+		totalVotingPower: string;
+	};
+	executionResult?: {
+		success: boolean;
+		transactionId?: string;
+		error?: string;
+	};
+}
+export interface GovernanceConfig {
+	governanceTokenId: string;
+	decimals?: number;
+	votingPowerMethod?: GovernanceVotingPowerMethod;
+	quorumPercent?: number;
+	approvalThresholdPercent?: number;
+	proposalThreshold: string;
+	votingPeriodMs: number;
+	timeLockMs?: number;
+	maxExecutionDelayMs?: number;
+	votingEligibility?: Record<string, unknown>;
+	proposalEligibility?: Record<string, unknown>;
+	allowDelegation?: boolean;
+	allowVoteChange?: boolean;
+	vetoCouncil?: string[];
+	maxActiveProposalsPerAccount?: number;
+	proposalCooldownMs?: number;
+	wisdomWeightFn?: {
+		registryKey: string;
+	};
+	delegation?: {
+		maxHops?: number;
+		decayPerHop?: number;
+		concentrationAlert?: number;
+	};
+	description?: string;
+}
+export interface GovernanceValidationContext {
+	chain?: string;
+	network?: "mainnet" | "testnet";
+	callerAccountId: string;
+	timestamp?: string | Date;
+	action: "create_proposal" | "cast_vote" | "execute_proposal" | "cancel_proposal" | "veto" | "delegate";
+	proposal?: GovernanceProposalData;
+	voteType?: GovernanceVoteType;
+	tokenBalance?: string;
+	votingPower?: string;
+	lastProposalAt?: string | Date;
+	activeProposalCount?: number;
+	delegation?: {
+		delegateTo?: string;
+		delegatedPower?: string;
+	};
+	daoId?: string;
+	totalDaoVotingPower?: string;
+}
+export interface GovernanceValidationResult {
+	isValid: boolean;
+	reason?: string;
+	metadata?: Record<string, unknown>;
+	validatedAt?: string;
+}
+export interface GovernanceSimulateRequest {
+	config: GovernanceConfig;
+	context: GovernanceValidationContext;
+}
+declare class GovernanceClient {
+	private readonly http;
+	constructor(http: HttpClient);
+	simulate(params: GovernanceSimulateRequest): Promise<GovernanceValidationResult>;
+}
+export type PersonhoodAttestationMethod = "web-of-trust" | "biometric" | "pop-protocol";
+export interface PersonhoodProof {
+	attestationMethod: PersonhoodAttestationMethod;
+	payload: unknown;
+}
+export interface PersonhoodCert {
+	address: string;
+	issuerId: string;
+	attestationMethod: PersonhoodAttestationMethod;
+	issuedAt: number;
+	expiresAt: number;
+	signature: string;
+}
+export interface PersonhoodVerifyParams {
+	candidate: string;
+	proof: PersonhoodProof;
+}
+declare class PersonhoodClient {
+	private readonly http;
+	constructor(http: HttpClient);
+	verify(params: PersonhoodVerifyParams): Promise<PersonhoodCert | null>;
+}
 export interface SmartEngineClientConfig {
 	baseUrl: string;
 	apiKey?: string;
@@ -1276,6 +1433,28 @@ export interface NetworkConnectionConfig {
 	mirrorNodeUrl?: string;
 	allowInsecure?: boolean;
 }
+export interface ClusterConnectionConfig {
+	bootstrap: string[];
+	chain: AuthChain;
+	address: string;
+	publicKey: string;
+	signFn: (challenge: string) => string | Promise<string>;
+	metadata?: {
+		appId?: string;
+		appName?: string;
+	};
+	trustAnchor?: {
+		network: "mainnet" | "testnet" | "previewnet";
+		registryTopicId: string;
+		mirrorNodeUrl?: string;
+	};
+	allowInsecure?: boolean;
+}
+export interface ClusterConnectionResult {
+	client: SmartEngineClient;
+	cluster: ClusterInfo;
+	session: AuthenticateResponse;
+}
 export interface NetworkConnectionResult {
 	client: SmartEngineClient;
 	validator: ValidatorInfo;
@@ -1292,9 +1471,13 @@ declare class SmartEngineClient {
 	readonly ipfs: IPFSClient;
 	readonly transactions: TransactionsClient;
 	readonly snapshots: SnapshotsClient;
+	readonly historicalBalance: HistoricalBalanceClient;
 	readonly settlement: SettlementClient;
+	readonly governance: GovernanceClient;
+	readonly personhood: PersonhoodClient;
 	constructor(config: SmartEngineClientConfig);
 	static connectToNetwork(config: NetworkConnectionConfig): Promise<NetworkConnectionResult>;
+	static connectToCluster(config: ClusterConnectionConfig): Promise<ClusterConnectionResult>;
 	getBaseUrl(): string;
 	isAuthenticated(): boolean;
 	getHttpHealth(): {
@@ -1717,7 +1900,6 @@ export type BaasEndpoints = {
 	functions: string;
 	messaging: string;
 };
-export type DeployedAppStatus = "pending" | "deploying" | "active" | "suspended" | "deleted";
 export type DeployedAppInfo = {
 	appId: string;
 	name: string;
@@ -1761,24 +1943,6 @@ export type BaasSessionInfo = {
 	expiresAt?: number;
 	error?: string;
 };
-export type BaasRegisterRequest = {
-	name: string;
-	services: BaasService[];
-	environment?: Record<string, string>;
-	limits?: {
-		storage?: string;
-		functions?: number;
-		channels?: number;
-	};
-};
-export type BaasRegisterResponse = {
-	appId: string;
-	name: string;
-	status: DeployedAppStatus;
-	services: string[];
-	endpoints: BaasEndpoints;
-	createdAt: string;
-};
 export type BaasDocument = {
 	_id: string;
 	data: Record<string, unknown>;
@@ -1956,18 +2120,56 @@ export type BaasPublishResult = {
 	channel: string;
 	timestamp: string;
 };
-export type BaasDeployRequest = {
+export type BaasInitRequest = {
 	name: string;
+	port: number;
 	services: BaasService[];
-	config?: Record<string, unknown>;
+	limits?: {
+		cpu?: string;
+		memory?: string;
+	};
 };
-export type BaasDeployResult = {
+export type BaasInitResponse = {
 	appId: string;
-	name: string;
-	status: "active" | "deploying" | "error";
-	services: string[];
-	endpoints: BaasEndpoints;
-	createdAt: string;
+	registry: {
+		server: string;
+		username: string;
+		password: string;
+		repository: string;
+	};
+};
+export type BaasDeployRequest = {
+	tag: string;
+	replicas?: number;
+	env?: Record<string, string>;
+	resources?: {
+		cpu?: string;
+		memory?: string;
+	};
+	strategy?: "rolling" | "recreate";
+};
+export type BaasDeployResponse = {
+	appId: string;
+	status: string;
+	url: string;
+};
+export type BaasUploadFrontendResponse = {
+	bundleSha256: string;
+	bundleSizeBytes: number;
+};
+export type BaasRollbackRequest = {
+	toTag: string;
+};
+export type BaasRuntimeStatus = {
+	appId: string;
+	state: "PENDING_SUBSCRIPTION" | "ACTIVE" | "SUSPENDED" | "RETIRED";
+	runtime?: {
+		image: string;
+		runtimeState: "NOT_DEPLOYED" | "DEPLOYING" | "RUNNING" | "FAILED" | "DEGRADED";
+		replicas: number;
+		lastReconciledAt?: string;
+		lastError?: string;
+	};
 };
 export type BaasAppListResponse = {
 	apps: DeployedAppInfo[];
@@ -2100,7 +2302,11 @@ declare class MessagingClient {
 declare class DeploymentClient {
 	private readonly http;
 	constructor(http: HttpClient);
-	create(request: BaasDeployRequest): Promise<BaasDeployResult>;
+	init(request: BaasInitRequest): Promise<BaasInitResponse>;
+	uploadFrontend(appId: string, bundle: Blob | Buffer, filename?: string): Promise<BaasUploadFrontendResponse>;
+	deploy(appId: string, request: BaasDeployRequest): Promise<BaasDeployResponse>;
+	rollback(appId: string, request: BaasRollbackRequest): Promise<BaasDeployResponse>;
+	status(appId: string): Promise<BaasRuntimeStatus>;
 	list(): Promise<BaasAppListResponse>;
 	get(appId: string): Promise<DeployedAppInfo>;
 	update(appId: string, updates: Partial<BaasDeployRequest>): Promise<DeployedAppInfo>;
@@ -2115,7 +2321,11 @@ declare class DeploymentClient {
 		success: boolean;
 		status: string;
 	}>;
-	getStats(): Promise<any>;
+	getStats(): Promise<{
+		totalApps: number;
+		activeApps: number;
+		totalOwners: number;
+	}>;
 }
 export type AgentStatus = "active" | "paused" | "revoked" | "pending";
 export type AgentRegisterRequest = {
@@ -2226,6 +2436,55 @@ declare class AgentsClient {
 		success: boolean;
 	}>;
 }
+export type CustomerSessionChallenge = {
+	challenge: string;
+};
+export type CustomerSessionVerifyRequest = {
+	appId: string;
+	chain: string;
+	address: string;
+	publicKey?: string;
+	signature: string;
+	challenge: string;
+};
+export type CustomerSessionToken = {
+	token: string;
+	sessionId: string;
+	validatorId: string;
+	expiresAt: string;
+	sessionSecret: string;
+};
+export type CustomerSessionInfo = {
+	sessionId: string;
+	appId: string;
+	customerChain: string;
+	customerAddress: string;
+	subscriptionContext?: {
+		nftSerial: number;
+		tier: "free_testnet" | "starter" | "professional" | "enterprise";
+		expiresAt: string;
+		allowedAutomations?: string[];
+	};
+	createdAt: string;
+	expiresAt: string;
+	lastActivityAt: string;
+};
+declare class CustomerSessionClient {
+	private readonly baseUrl;
+	private readonly timeoutMs;
+	constructor(baseUrl: string, timeoutMs?: number);
+	challenge(input: {
+		chain: string;
+		address: string;
+	}): Promise<CustomerSessionChallenge>;
+	verify(req: CustomerSessionVerifyRequest): Promise<CustomerSessionToken>;
+	validate(bearer: string): Promise<CustomerSessionInfo>;
+	end(bearer: string): Promise<{
+		revoked: boolean;
+		sessionId: string;
+	}>;
+	private fetch;
+}
 export type AuthenticateOptions = {
 	chain: BaasSupportedChain;
 	walletAddress: string;
@@ -2247,6 +2506,7 @@ declare class BaasClient {
 	readonly messaging: MessagingClient;
 	readonly deployment: DeploymentClient;
 	readonly agents: AgentsClient;
+	readonly customerSession: CustomerSessionClient;
 	constructor(config: BaasClientConfig);
 	setAppId(appId: string): void;
 	isAuthenticated(): boolean;
@@ -2259,7 +2519,6 @@ declare class BaasClient {
 	authenticate(options: AuthenticateOptions): Promise<BaasAuthResult>;
 	validateSession(): Promise<BaasSessionInfo>;
 	logout(): Promise<void>;
-	register(request: BaasRegisterRequest): Promise<BaasRegisterResponse>;
 	private requireAuth;
 	private getHeaders;
 	private post;