Inline docs and README

[nfurfaro]

Also adds a performance test.

closes #20

Performance Test Output

=== Transfers Performance Test ===
Configuration:
  - Number of operation cycles: 50
  - Operations per cycle: 3 (deposit, transfer, withdrawal_request)
  - Total transactions: 150
  - Progress updates every: 10 cycles

[Setup] Starting local Reth node...
[Setup] Reth node started on http://localhost:7550
[Setup] Using signer address: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
[Setup] Deploying Transfers contract...
[Setup] Transfers contract deployed at: 0x5FbDB2315678afecb367f032d93F642f64180aa3
[Setup] Deploying TestToken contract...
[Setup] TestToken deployed at: 0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512
[Setup] Minting tokens to main user...
[Setup] Approving Transfers contract...
[Setup] Starting Transfers app...
Server running on http://127.0.0.1:3505
Successfully connected to: http://127.0.0.1:3505/: OK
[Setup] Transfers app started on http://127.0.0.1:3505

=== Performance Test Started ===

[Progress] 10/50 cycles (30 txs) | Elapsed: 11.52s | Current TPS: 2.60
[Progress] 20/50 cycles (60 txs) | Elapsed: 23.04s | Current TPS: 2.60
[Progress] 30/50 cycles (90 txs) | Elapsed: 33.99s | Current TPS: 2.65
[Progress] 40/50 cycles (120 txs) | Elapsed: 45.49s | Current TPS: 2.64
test test_performance has been running for over 60 seconds
[Progress] 50/50 cycles (150 txs) | Elapsed: 56.99s | Current TPS: 2.63

=== Performance Test Complete ===

=== Detailed Metrics ===

Total Performance:
  - Total transactions: 150
  - Total duration: 56.99s
  - Average TPS: 2.63 transactions/second

On-Chain Transaction Times:
  - Average: 301ms
  - Minimum: 153ms
  - Maximum: 441ms

Off-Chain Processing Times (Oracle + State Update):
  - Average: 79ms
  - Minimum: 8ms
  - Maximum: 176ms

=== State Verification ===
  - User balance: 4500000000000000000000
  - Bob balance: 0
  - Total bridge balance: 4500000000000000000000

=== Test Passed ===
test test_performance ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 1 filtered out; finished in 66.17s