Merge pull request #94 from unicitynetwork/issue-91

Payment module

Author: b3y0urs3lf

README.md

@@ -1,11 +1,9 @@
 # State Transition SDK
 
-An SDK for managing assets on the Unicity Protocol, supporting off-chain state with on-chain security guarantees.
-
 ## Overview
 
 The State Transition SDK is a TypeScript library that provides an off-chain token transaction framework. Tokens are managed, stored, and transferred off-chain with only cryptographic commitments published on-chain, ensuring privacy while preventing double-spending through single-spend proofs.
-
+This is a low-level SDK, that supports transferring tokens, making payments, and splitting tokens. 
 In this system, tokens are self-contained entities containing complete transaction history and cryptographic proofs attesting to their current state (ownership, value, etc.). State transitions are verified through consultation with blockchain infrastructure (Unicity) to produce proof of single spend.
 
 ### Key Features
@@ -63,6 +61,35 @@ I --> J[End]
 
 ### Token Structure
 
+```
+Token {
+  genesis: CertifiedMintTransaction {
+    transaction: MintTransaction {
+      sourceStateHash: MintTransactionState,
+      lockScript: IPredicate,
+      recipient: PayToScriptHash,
+      tokenId: TokenId,
+      tokenType: TokenType,
+      data: Uint8Array
+    },
+    inclusionProof: InclusionProof
+  },
+  transactions: [
+    CertifiedTransferTransaction {
+      transaction: TransferTransaction {
+        sourceStateHash: DataHash,
+        lockScript: IPredicate,
+        recipient: PayToScriptHash,
+        x: Uint8Array,
+        data: Uint8Array
+      },
+      inclusionProof: InclusionProof
+    },
+    ...
+  ]
+}
+```
+
 ### Privacy Model
 - **Commitment-based**: Only cryptographic commitments published on-chain
 - **Self-contained**: Tokens include complete transaction history
@@ -129,16 +156,14 @@ npm run lint:fix
 
 ## Examples
 
-### Minting Tokens
-
-Note that the examples here are using some utility functions and classes that are defined below in a separate section.
-
-```typescript
-```
+### Minting Tokens 
+`tests/examples/mint/ExampleTest.ts`
 
 ### Token Transfer
+`tests/examples/transfer/ExampleTest.ts`
 
-### Checking Token Status
+### Token Splitting
+`tests/examples/split/ExampleTest.ts`
 
 ## Unicity Signature Standard