Add SID (Sovereign Identity) API implementation (#2)

* Add complete SID API methods for backup, recovery, and guardians

- Add backup operations: export, import, verify
- Add seed phrase operations: verify, export
- Add guardian management: add, list, remove, accept, decline
- Add guardian recovery flow: initiate, approve, status, cancel
- Add citizenship application endpoint
- Fix endpoint paths to match core API
- Add all required TypeScript types for SID features

* Add comprehensive unit tests for SID API methods

- Add 22 tests for backup operations (export, import, verify)
- Add tests for seed phrase operations (verify, export)
- Add tests for guardian management (add, list, remove, accept, decline)
- Add tests for guardian recovery flow (initiate, approve, status, cancel)
- Add tests for citizenship application
- Add error handling tests for HTTP errors
- Increase zhtp-api-methods coverage from 47.65% to 59.37%
- Increase overall test count from 168 to 190 tests

* Add comprehensive ZHTP API integration tests

Author: umwelt

dist/core/types.d.ts

@@ -248,4 +248,71 @@ export interface CitizenshipResult {
         bonus_amount: number;
     };
 }
+export interface BackupData {
+    version: string;
+    encrypted_data: string;
+    metadata: {
+        created_at: number;
+        identity_id: string;
+        backup_type: string;
+    };
+}
+export interface BackupVerification {
+    valid: boolean;
+    version: string;
+    created_at: number;
+    identity_id?: string;
+    errors: string[];
+    warnings: string[];
+}
+export interface SeedVerification {
+    valid: boolean;
+    wallet_id?: string;
+    wallet_type?: string;
+}
+export interface SeedPhrases {
+    primary?: string[];
+    ubi?: string[];
+    savings?: string[];
+    master?: string[];
+}
+export interface Guardian {
+    guardian_id: string;
+    guardian_name?: string;
+    status: 'pending' | 'active' | 'revoked';
+    added_at: number;
+    relationship?: string;
+}
+export interface GuardianResponse {
+    status: string;
+    guardian_id: string;
+    message: string;
+}
+export interface RecoverySession {
+    recovery_id: string;
+    identity_id: string;
+    status: 'initiated' | 'pending_approvals' | 'completed' | 'cancelled';
+    required_approvals: number;
+    current_approvals: number;
+    guardian_ids: string[];
+    created_at: number;
+    expires_at: number;
+}
+export interface RecoveryStatus {
+    recovery_id: string;
+    status: 'initiated' | 'pending_approvals' | 'completed' | 'cancelled' | 'failed';
+    progress: {
+        required: number;
+        approved: number;
+        declined: number;
+    };
+    guardians: Array<{
+        guardian_id: string;
+        status: 'pending' | 'approved' | 'declined';
+        responded_at?: number;
+    }>;
+    created_at: number;
+    updated_at: number;
+    expires_at: number;
+}
 //# sourceMappingURL=types.d.ts.map

dist/core/types.d.ts.map

@@ -3,7 +3,7 @@
  * All API method implementations for various operations
  */
 import { ZhtpApiCore } from './zhtp-api-core';
-import { Identity, Wallet, NetworkStatus, DaoProposal, DaoStats, Transaction, Delegate, ProposalDetails, TreasuryRecord, DApp, SmartContract, ContractDeploymentResult, ContractExecutionResult, Asset, NodeStatus, Proof, SignupRequest, LoginRequest } from './types';
+import { Identity, Wallet, NetworkStatus, DaoProposal, DaoStats, Transaction, Delegate, ProposalDetails, TreasuryRecord, DApp, SmartContract, ContractDeploymentResult, ContractExecutionResult, Asset, NodeStatus, Proof, SignupRequest, LoginRequest, BackupData, BackupVerification, SeedVerification, SeedPhrases, Guardian, GuardianResponse, RecoverySession, RecoveryStatus, CitizenshipResult } from './types';
 export declare abstract class ZhtpApiMethods extends ZhtpApiCore {
     signIn(did: string, passphrase: string): Promise<Identity>;
     createIdentity(data: any): Promise<Identity>;
@@ -27,6 +27,21 @@ export declare abstract class ZhtpApiMethods extends ZhtpApiCore {
     recoverIdentityFromSeed(recoveryData: Record<string, any>): Promise<Identity>;
     restoreIdentityFromBackup(backupData: Record<string, any>): Promise<Identity>;
     recoverIdentityWithGuardians(guardianData: Record<string, any>): Promise<Identity>;
+    exportBackup(identityId: string, password: string): Promise<BackupData>;
+    importBackup(backupData: string, password: string): Promise<Identity>;
+    verifyBackup(backupData: string): Promise<BackupVerification>;
+    verifySeedPhrase(identityId: string, seedPhrase: string): Promise<SeedVerification>;
+    exportSeedPhrases(identityId: string): Promise<SeedPhrases>;
+    addGuardian(identityId: string, guardianId: string, guardianInfo?: Record<string, any>): Promise<GuardianResponse>;
+    listGuardians(identityId: string): Promise<Guardian[]>;
+    removeGuardian(identityId: string, guardianId: string): Promise<void>;
+    acceptGuardianInvite(guardianId: string, identityId: string): Promise<void>;
+    declineGuardianInvite(guardianId: string, identityId: string): Promise<void>;
+    initiateRecovery(identityId: string, guardianIds: string[]): Promise<RecoverySession>;
+    approveRecovery(guardianId: string, recoveryId: string, approval: boolean): Promise<void>;
+    getRecoveryStatus(recoveryId: string): Promise<RecoveryStatus>;
+    cancelRecovery(recoveryId: string): Promise<void>;
+    applyCitizenship(identityId: string, applicationData?: Record<string, any>): Promise<CitizenshipResult>;
     createZkDid(didData?: Record<string, any>): Promise<any>;
     getIdentity(did: string): Promise<Identity>;
     verifyIdentity(did: string, requirements?: Record<string, any>): Promise<boolean>;