@hsuite/smart-engines-sdk 3.0.3 → 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;
@@ -1211,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;
@@ -1252,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;
@@ -1274,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;
@@ -1290,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(): {
@@ -1706,7 +1891,7 @@ declare class SmartGatewayClient {
 	getMetrics(refresh?: boolean): Promise<GatewayMetricsResponse>;
 	getMetricsSummary(): Promise<GatewayMetricsSummaryResponse>;
 }
-export type BaasService = "auth" | "database" | "storage" | "functions" | "messaging" | "customer-session";
+export type BaasService = "auth" | "database" | "storage" | "functions" | "messaging";
 export type BaasSupportedChain = "hedera" | "xrpl" | "polkadot" | "solana";
 export type BaasEndpoints = {
 	auth: string;