Getting Started with Stellar

npm install @attestprotocol/stellar-sdk @stellar/stellar-sdk

import { StellarAttestationClient } from '@attestprotocol/stellar-sdk';
import { Keypair, Networks, Transaction } from '@stellar/stellar-sdk';

const keypair = Keypair.fromSecret(process.env.STELLAR_SECRET_KEY!);

const signer = {
  signTransaction: async (xdr: string) => {
    const tx = new Transaction(xdr, Networks.TESTNET);
    tx.sign(keypair);
    return tx.toXDR();
  }
};

const client = new StellarAttestationClient({
  rpcUrl: 'https://soroban-testnet.stellar.org',
  network: 'testnet',
  publicKey: keypair.publicKey()
});

const result = await client.createSchema({
  definition: 'struct Identity { string name; u32 age; bool verified; }',
  revocable: true,
  options: { signer }
});

// Get schema UID for later use
const schemaUid = client.generateSchemaUid({
  definition: 'struct Identity { string name; u32 age; bool verified; }',
  authority: keypair.publicKey()
});

await client.attest({
  schemaUid,
  value: JSON.stringify({
    name: 'Alice',
    age: 30,
    verified: true
  }),
  expirationTime: Date.now() + 365 * 24 * 60 * 60 * 1000, // 1 year
  options: { signer }
});

// By UID
const attestation = await client.getAttestation(attestationUid);

// By wallet
const { attestations } = await client.fetchAttestationsByWallet({
  walletAddress: 'GXXX...',
  limit: 50
});

// Latest attestations
const latest = await client.fetchAttestations(100);

await client.revoke({
  attestationUid,
  options: { signer }
});

// Generate BLS keys
const blsKeys = client.generateBlsKeys();

// Register public key on-chain
await client.registerBlsKey(Buffer.from(blsKeys.publicKey), { signer });

// Create delegated attestation (submitter pays gas)
await client.attestByDelegation({
  attester: keypair.publicKey(),
  schema_uid: schemaUid,
  subject: 'GSUBJECT...',
  value: JSON.stringify({ verified: true }),
  nonce: BigInt(1),
  deadline: BigInt(Date.now() + 3600000),
  expiration_time: undefined,
  signature: signatureBuffer
}, { signer: submitterSigner });

import { ContractError, NetworkError } from '@attestprotocol/stellar-sdk';

try {
  await client.attest({ ... });
} catch (error) {
  if (error instanceof ContractError) {
    console.log('Contract error:', error.message);
  } else if (error instanceof NetworkError) {
    console.log('Network error:', error.message);
  }
}