@hashgraphonline/standards-sdk 0.1.165 → 0.1.166

package/dist/browser/hcs-12/sdk.d.ts

@@ -0,0 +1,112 @@
+import { Client, PrivateKey, PublicKey, KeyList } from '../../node_modules/@hashgraph/sdk';
+import { HCS12BaseClient, HCS12Config } from './base-client';
+import { RegistryType, AssemblyRegistration, AssemblyAddBlock, AssemblyAddAction, AssemblyUpdate } from './types';
+import { ActionBuilder, AssemblyBuilder, BlockBuilder } from './builders';
+import { RetrievedInscriptionResult } from '../inscribe/types';
+/**
+ * Configuration for HCS-12 SDK client
+ */
+export interface HCS12ClientConfig extends HCS12Config {
+    /** Operator account ID */
+    operatorId: string;
+    /** Operator private key */
+    operatorPrivateKey: string | PrivateKey;
+}
+/**
+ * HCS-12 SDK client for server-side HashLinks operations
+ */
+export declare class HCS12Client extends HCS12BaseClient {
+    private client;
+    private operatorAccountId;
+    private operatorCtx;
+    constructor(config: HCS12ClientConfig);
+    /**
+     * Initialize registries with optional existing topic IDs
+     */
+    initializeRegistries(topicIds?: {
+        action?: string;
+        assembly?: string;
+        hashlinks?: string;
+    }): void;
+    /**
+     * Create a new HCS topic for a registry
+     */
+    createRegistryTopic(registryType: RegistryType, adminKey?: boolean | PublicKey | KeyList, submitKey?: boolean | PublicKey | KeyList): Promise<string>;
+    /**
+     * Register an assembly on its own topic
+     */
+    registerAssemblyDirect(assemblyTopicId: string, registration: AssemblyRegistration): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Add a block to an assembly
+     */
+    addBlockToAssembly(assemblyTopicId: string, block: AssemblyAddBlock): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Add an action to an assembly
+     */
+    addActionToAssembly(assemblyTopicId: string, action: AssemblyAddAction): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Update assembly metadata
+     */
+    updateAssembly(assemblyTopicId: string, update: AssemblyUpdate): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Submit a message to an HCS topic
+     * @deprecated Use operation-specific methods instead
+     */
+    submitMessage(topicId: string, message: string, submitKey?: PrivateKey): Promise<{
+        transactionId: string;
+        sequenceNumber?: number;
+    }>;
+    /**
+     * Internal method to submit a message to an HCS topic
+     */
+    private _submitMessage;
+    /**
+     * Get the Hedera client instance
+     */
+    getClient(): Client;
+    /**
+     * Get operator account ID
+     */
+    getOperatorAccountId(): string;
+    /**
+     * Get operator private key
+     */
+    getOperatorPrivateKey(): string;
+    /**
+     * Inscribe a file using HCS-1 protocol
+     */
+    inscribeFile(buffer: Buffer, fileName: string, options?: {
+        progressCallback?: (progress: any) => void;
+        waitMaxAttempts?: number;
+        waitIntervalMs?: number;
+    }): Promise<RetrievedInscriptionResult>;
+    /**
+     * Create a new assembly topic
+     */
+    createAssemblyTopic(): Promise<string>;
+    /**
+     * Register an action
+     */
+    registerAction(builder: ActionBuilder): Promise<ActionBuilder>;
+    /**
+     * Register a block
+     */
+    registerBlock(builder: BlockBuilder): Promise<BlockBuilder>;
+    /**
+     * Create an assembly using AssemblyBuilder
+     */
+    createAssembly(builder: AssemblyBuilder): Promise<string>;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/browser/hcs-12/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/hcs-12/sdk.ts"],"names":[],"mappings":"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"}

package/dist/browser/hcs-12/security/hash-verifier.d.ts

@@ -0,0 +1,195 @@
+import { Logger } from '../../utils/logger';
+export interface HashVerifierConfig {
+    logger: Logger;
+    defaultAlgorithm?: string;
+}
+export interface WasmManifest {
+    codeHash: string;
+    metadataHash: string;
+    combinedHash: string;
+    algorithm: string;
+    timestamp: number;
+}
+export interface WasmVerificationResult {
+    valid: boolean;
+    codeIntegrity?: boolean;
+    metadataIntegrity?: boolean;
+    error?: string;
+}
+export interface AssemblyHashTree {
+    root: string;
+    components: Record<string, string>;
+    metadata?: string;
+    algorithm: string;
+}
+export interface AssemblyVerificationResult {
+    valid: boolean;
+    invalidComponents: string[];
+    error?: string;
+}
+export interface ComponentVerificationResult {
+    valid: boolean;
+    verifiedCount: number;
+    failedComponents?: string[];
+}
+export interface Resource {
+    id: string;
+    type: string;
+    content: Buffer;
+    contentType?: string;
+    encoding?: string;
+}
+export interface MerkleTree {
+    root: string;
+    proof: Record<number, string[]>;
+    leaves: string[];
+}
+export interface HashChainVerification {
+    valid: boolean;
+    chainLength: number;
+    brokenAt?: number;
+}
+export interface CacheConfig {
+    maxSize: number;
+    ttlMs: number;
+}
+export interface KeyDerivationOptions {
+    iterations: number;
+    keyLength: number;
+    algorithm: 'pbkdf2' | 'scrypt' | 'argon2';
+}
+/**
+ * Cryptographic hash verification system
+ */
+export declare class HashVerifier {
+    private logger;
+    private config;
+    private cache;
+    private cacheConfig?;
+    private cryptoAdapter;
+    constructor(config: HashVerifierConfig);
+    /**
+     * Hash content with specified algorithm
+     */
+    hash(content: Buffer, algorithm?: string): Promise<string>;
+    /**
+     * Create deterministic placeholder hash for SSR environments
+     */
+    private createSSRSafeHash;
+    /**
+     * Create WASM module manifest
+     */
+    createWasmManifest(module: {
+        id: string;
+        code: Uint8Array;
+        metadata: Record<string, unknown>;
+    }): Promise<WasmManifest>;
+    /**
+     * Verify WASM module integrity
+     */
+    verifyWasmModule(module: {
+        id: string;
+        code: Uint8Array;
+        metadata: Record<string, unknown>;
+    }, manifest: WasmManifest): Promise<WasmVerificationResult>;
+    /**
+     * Create assembly hash tree
+     */
+    createAssemblyHashTree(assembly: {
+        id: string;
+        components: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+    }): Promise<AssemblyHashTree>;
+    /**
+     * Verify assembly hash tree
+     */
+    verifyAssemblyHashTree(assembly: {
+        id: string;
+        components: Record<string, unknown>;
+    }, hashTree: AssemblyHashTree): Promise<AssemblyVerificationResult>;
+    /**
+     * Verify specific components
+     */
+    verifyComponents(assembly: {
+        components: Record<string, unknown>;
+    }, hashTree: AssemblyHashTree, componentIds: string[]): Promise<ComponentVerificationResult>;
+    /**
+     * Hash resource
+     */
+    hashResource(resource: Resource): Promise<string>;
+    /**
+     * Verify resource integrity
+     */
+    verifyResource(resource: Resource, expectedHash: string): Promise<boolean>;
+    /**
+     * Compute merkle root
+     */
+    computeMerkleRoot(hashes: string[]): Promise<string>;
+    /**
+     * Verify chunks against merkle root
+     */
+    verifyChunks(chunks: Buffer[], merkleRoot: string): Promise<{
+        valid: boolean;
+    }>;
+    /**
+     * Build merkle tree
+     */
+    buildMerkleTree(leaves: string[]): Promise<MerkleTree>;
+    /**
+     * Get merkle proof for a leaf
+     */
+    getMerkleProof(tree: MerkleTree, leafIndex: number): Promise<string[]>;
+    /**
+     * Verify merkle proof
+     */
+    verifyMerkleProof(leaf: string, proof: string[], root: string): Promise<boolean>;
+    /**
+     * Verify hash chain
+     */
+    verifyHashChain(chain: string[]): Promise<HashChainVerification>;
+    /**
+     * Enable caching
+     */
+    enableCaching(config: CacheConfig): void;
+    /**
+     * Batch hash operation
+     */
+    batchHash(contents: Buffer[]): Promise<string[]>;
+    /**
+     * Hash with salt
+     */
+    hashWithSalt(content: Buffer, salt: Buffer): Promise<string>;
+    /**
+     * Derive key from password
+     */
+    deriveKey(password: string, salt: Buffer, options: KeyDerivationOptions): Promise<string>;
+    /**
+     * Create SSR-safe key derivation
+     */
+    private createSSRSafeKey;
+    /**
+     * Create HMAC
+     */
+    createHMAC(content: Buffer, secret: Buffer): Promise<string>;
+    /**
+     * Create SSR-safe HMAC
+     */
+    private createSSRSafeHMAC;
+    /**
+     * Verify HMAC
+     */
+    verifyHMAC(content: Buffer, hmac: string, secret: Buffer): Promise<boolean>;
+    /**
+     * Get from cache
+     */
+    private getFromCache;
+    /**
+     * Add to cache
+     */
+    private addToCache;
+    /**
+     * Generate merkle proof
+     */
+    private generateProof;
+}
+//# sourceMappingURL=hash-verifier.d.ts.map

package/dist/browser/hcs-12/security/hash-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-verifier.d.ts","sourceRoot":"","sources":["../../../../src/hcs-12/security/hash-verifier.ts"],"names":[],"mappings":"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"}

package/dist/browser/hcs-12/security/permission-system.d.ts

@@ -0,0 +1,254 @@
+import { Logger } from '../../utils/logger';
+export interface DelegationInfo {
+    delegatorId: string;
+    permissions: string[];
+    validUntil: Date;
+}
+export type PermissionConditionValue = string | number | boolean | Date | {
+    maxRequests: number;
+    windowMs: number;
+} | {
+    keyGenerator: (context: UserContext) => string;
+} | {
+    requiredContext?: Record<string, string>;
+    customValidator?: (context: UserContext) => boolean;
+};
+export interface PermissionCondition {
+    type: 'time-based' | 'rate-limit' | 'conditional' | 'custom';
+    value: PermissionConditionValue;
+}
+export interface AuditEvent {
+    timestamp: Date;
+    action: string;
+    userId: string;
+    resourceId?: string;
+    result: boolean;
+    reason?: string;
+}
+export interface PermissionSystemConfig {
+    logger: Logger;
+    enableAudit?: boolean;
+    enableRateLimiting?: boolean;
+    defaultDenyPolicy?: boolean;
+}
+export interface Capability {
+    name: string;
+    description: string;
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    requiresApproval?: boolean;
+    inherits?: string[];
+    requires?: string[];
+}
+export interface Role {
+    name: string;
+    capabilities: string[];
+    inherits?: string[];
+}
+export interface UserContext {
+    userId: string;
+    capabilities?: string[];
+    roles?: string[];
+    actingAs?: string;
+    delegation?: DelegationInfo;
+    delegationId?: string;
+}
+export interface Resource {
+    id: string;
+    type: string;
+    owner: string;
+    permissions: {
+        read?: string[];
+        write?: string[];
+        delete?: string[];
+        execute?: string[];
+        [key: string]: string[] | undefined;
+    };
+    groups?: Record<string, string[]>;
+}
+export interface Action {
+    id: string;
+    requiredCapabilities: string[];
+    metadata?: {
+        riskLevel?: string;
+        requiresSignature?: boolean;
+    };
+    sideEffects?: string[];
+}
+export interface PermissionValidationResult {
+    allowed: boolean;
+    reason?: string;
+    missingCapabilities?: string[];
+    grantedCapabilities?: string[];
+    securityAlert?: boolean;
+    conditions?: PermissionCondition[];
+}
+export type PolicyConditions = {
+    type: 'time-based';
+    validFrom?: Date;
+    validUntil?: Date;
+} | {
+    type: 'rate-limit';
+    maxRequests: number;
+    windowMs: number;
+    keyGenerator: (context: UserContext) => string;
+} | {
+    type: 'conditional';
+    requiredContext?: Record<string, string>;
+    customValidator?: (context: UserContext) => boolean;
+};
+export interface Policy {
+    id: string;
+    type: 'time-based' | 'rate-limit' | 'conditional';
+    conditions: PolicyConditions;
+}
+export interface PermissionDelegation {
+    from: string;
+    to: string;
+    capabilities: string[];
+    validUntil: Date;
+    conditions?: PermissionCondition[];
+}
+export interface PermissionBoundary {
+    maxCapabilities?: string[];
+    deniedCapabilities?: string[];
+    allowedResources?: string[];
+    deniedResources?: string[];
+}
+export interface ComplianceReport {
+    summary: {
+        totalChecks: number;
+        allowedCount: number;
+        deniedCount: number;
+    };
+    byUser: Record<string, {
+        allowed: number;
+        denied: number;
+    }>;
+    byAction?: Record<string, {
+        allowed: number;
+        denied: number;
+    }>;
+    byResource?: Record<string, {
+        allowed: number;
+        denied: number;
+    }>;
+}
+/**
+ * Comprehensive permission system for HashLinks
+ */
+export declare class PermissionSystem {
+    private logger;
+    private config;
+    private capabilities;
+    private roles;
+    private delegations;
+    private rateLimiters;
+    private auditLogger?;
+    private permissionBoundary?;
+    private auditLog;
+    constructor(config: PermissionSystemConfig);
+    /**
+     * Register a capability
+     */
+    registerCapability(capability: Capability): void;
+    /**
+     * Check if capability exists
+     */
+    hasCapability(name: string): boolean;
+    /**
+     * Get capability definition
+     */
+    getCapability(name: string): Capability | undefined;
+    /**
+     * Get effective capabilities including inheritance
+     */
+    getEffectiveCapabilities(capabilities: string[]): string[];
+    /**
+     * Validate capability requirements
+     */
+    validateCapabilities(required: string[], provided: string[]): {
+        valid: boolean;
+        missing: string[];
+    };
+    /**
+     * Register a role
+     */
+    registerRole(role: Role): void;
+    /**
+     * Get role capabilities including inheritance
+     */
+    getRoleCapabilities(context: UserContext): Promise<string[]>;
+    /**
+     * Validate action permissions
+     */
+    validateActionPermissions(action: Action, context: UserContext): Promise<PermissionValidationResult>;
+    /**
+     * Validate resource access
+     */
+    validateResourceAccess(resource: Resource, operation: string, context: UserContext): Promise<PermissionValidationResult>;
+    /**
+     * Evaluate policy
+     */
+    evaluatePolicy(policy: Policy, context: UserContext): Promise<PermissionValidationResult>;
+    /**
+     * Delegate permissions
+     */
+    delegatePermissions(delegation: PermissionDelegation): Promise<string>;
+    /**
+     * Revoke delegation
+     */
+    revokeDelegation(delegationId: string): Promise<void>;
+    /**
+     * Validate delegated permissions
+     */
+    validateDelegatedPermissions(capability: string, context: UserContext): Promise<PermissionValidationResult>;
+    /**
+     * Set audit logger
+     */
+    setAuditLogger(logger: (event: AuditEvent) => void): void;
+    /**
+     * Set permission boundary
+     */
+    setPermissionBoundary(boundary: PermissionBoundary): void;
+    /**
+     * Log permission event
+     */
+    logPermissionEvent(event: AuditEvent): Promise<void>;
+    /**
+     * Generate compliance report
+     */
+    generateComplianceReport(options: {
+        startDate: Date;
+        endDate: Date;
+        groupBy?: string;
+    }): Promise<ComplianceReport>;
+    /**
+     * Initialize default capabilities
+     */
+    private initializeDefaultCapabilities;
+    /**
+     * Evaluate time-based policy
+     */
+    private evaluateTimeBasedPolicy;
+    /**
+     * Evaluate rate limit policy
+     */
+    private evaluateRateLimitPolicy;
+    /**
+     * Evaluate conditional policy
+     */
+    private evaluateConditionalPolicy;
+    /**
+     * Detect privilege escalation attempts
+     */
+    private detectPrivilegeEscalation;
+    /**
+     * Check permission boundary
+     */
+    private checkPermissionBoundary;
+    /**
+     * Log audit event
+     */
+    private logAuditEvent;
+}
+//# sourceMappingURL=permission-system.d.ts.map

package/dist/browser/hcs-12/security/permission-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-system.d.ts","sourceRoot":"","sources":["../../../../src/hcs-12/security/permission-system.ts"],"names":[],"mappings":"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"}