feat: add contract client generation workflow for frontend (#81)

[cyber-excel10]

Closes #81

Description

This PR implements the contract client generation workflow for StellarStream (issue #81) and restores the README.md file that was accidentally deleted.

What's included

Issue #81: Contract Client Generation Workflow

• ✅ scripts/generate-contract-bindings.sh — Repeatable script to generate TypeScript bindings from deployed contract
• ✅ docs/CONTRACT_BINDINGS.md — Comprehensive 231-line workflow guide covering:
  • Prerequisites and setup
  • Step-by-step generation process
  • Generated types and methods
  • Frontend integration points (contractClient.ts, api.ts, useFreighter.ts)
  • Regeneration workflow for contributors
  • CI/automation guidance
  • Troubleshooting section
• ✅ npm run gen:bindings — Easy-to-use npm script
• ✅ Updated .gitignore to exclude generated bindings folder
• ✅ Updated README section 9 with scripts and docs references

README Restoration

• Restored README.md from last committed version 429 lines
• Includes all latest documentation updates
• Added section 9 references to new contract bindings workflow
• All sections verified and current

Acceptance Criteria (Issue #81)

• A repeatable generation command exists (npm run gen:bindings)
• Output location is documented (frontend/src/contracts/generated/)
• Frontend integration points are identified:
  • frontend/src/services/contractClient.ts — wrapper service
  • frontend/src/services/api.ts — integration points
  • frontend/src/hooks/useFreighter.ts — wallet signing
• Contributors can regenerate bindings without guesswork (full workflow documented)

Testing

# Verify script syntax
bash -n scripts/generate-contract-bindings.sh

# Test error handling (should show helpful message about missing CONTRACT_ID)
npm run gen:bindings

[vercel]

Someone is attempting to deploy a commit to the ritik4ever's projects Team on Vercel.

A member of the Team first needs to authorize it.

[drips-wave]

@cyber-excel10 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[cyber-excel10]

@ritik4ever Thank you for assigning me to this issue! I've completed the contract client generation workflow for issue #81.

Important Note

While working on this, I noticed that README.md was accidentally deleted in a recent PR. I've restored it and included the latest updates in this PR.

Could you please review:

1. That the restored README.md aligns with the project's current state
2. The new section 9 additions for the contract bindings workflow.

Thanks for the opportunity to contribute to StellarStream. I have learnt a lot from the few task assigned to me .

Looking forward to your feedback!