@rialo/ts-cdk 0.1.9 → 0.2.0-alpha.0

package/README.md

@@ -216,6 +216,30 @@ const airdropResult = await client.requestAirdropAndConfirm(
   publicKey,
   1_000_000_000n
 );
+
+// Get minimum balance for rent exemption
+const minBalance = await client.getMinimumBalanceForRentExemption(128);
+
+// Get fee for a message
+const fee = await client.getFeeForMessage(base64Message);
+
+// Batch query multiple accounts
+const accounts = await client.getMultipleAccounts([pubkey1, pubkey2]);
+
+// Get accounts by owner/program with pagination
+const result = await client.getAccountsByOwner(programId, { type: "programAccounts" });
+
+// Workflow lineage traversal
+const lineage = await client.getWorkflowLineage({
+  signature: rootTxSignature,
+  maxDepth: 5,
+});
+
+// Get subscription for an account and nonce
+const sub = await client.getSubscription(accountPubkey, "my-nonce");
+
+// Get transactions triggered by a subscription
+const triggered = await client.getTriggeredTransactions(subscriptionPubkey);
 ```
 
 ### Signers
@@ -245,6 +269,44 @@ class CustomSigner implements Signer {
 
 ## Advanced Features
 
+### Program Derived Addresses (PDAs)
+
+PDAs are deterministic addresses derived from seeds and a program ID. They are off the Ed25519 curve, meaning no private key exists for them - only the program can sign on their behalf.
+
+```typescript
+import { PublicKey } from "@rialo/ts-cdk";
+
+// Find a PDA with automatic bump seed discovery
+const [vaultPda, vaultBump] = PublicKey.findProgramAddress(
+  ["vault", userPubkey.toBytes()],
+  programId
+);
+
+console.log(`Vault: ${vaultPda}, Bump: ${vaultBump}`);
+
+// Create PDA with known bump (more efficient for verification)
+const pda = PublicKey.createProgramAddress(
+  ["metadata", mintPubkey.toBytes(), new Uint8Array([254])],
+  metadataProgramId
+);
+
+// Create derived address from base key (CAN be on curve)
+const derivedAddress = PublicKey.createWithSeed(
+  userPubkey,
+  "savings-account",
+  systemProgramId
+);
+
+// Check if an address is on the Ed25519 curve
+const isOnCurve = pubkey.isOnCurve();
+```
+
+**Seed Constraints:**
+
+- Maximum 16 seeds per derivation
+- Each seed maximum 32 bytes
+- Seeds can be strings (UTF-8 encoded) or `Uint8Array`
+
 ### Hierarchical Deterministic Wallets
 
 The SDK uses SLIP-0010 for Ed25519 key derivation with BIP44 paths.