Implement Blockchain Controller to Expose API Endpoints

[Josue19-08]

📌 Issue: Implement Blockchain Controller to Expose API Endpoints

🔹 Description

Expose RESTful API endpoints for blockchain interactions, allowing external services to fetch NFT balances, metadata, and execute token transfers via the ERC-1155 contract on StarkNet Testnet.

---

📂 Project Structure

• Controller: src/modules/blockchain/controllers/blockchain.controller.ts
• Service: src/modules/blockchain/services/starknet.service.ts
• DTOs: src/modules/blockchain/dtos/transfer.dto.ts

---

🛠️ Tasks

• Create blockchain.controller.ts to handle HTTP requests.
• Implement the following API endpoints:
  • GET /blockchain/balance/:account/:tokenId → Returns the balance of a specific token for a given account.
  • GET /blockchain/token/:tokenId → Returns metadata for a specific token.
  • POST /blockchain/transfer → Transfers a token between two accounts.
• Ensure request validation using DTOs.
• Implement error handling for invalid requests.
• Integrate the controller with StarknetService.
• Write unit tests to validate:
  • Correct responses for balance and metadata retrieval.
  • Successful transfers via API.
  • Handling of invalid input parameters.
• Generate API documentation using Swagger/OpenAPI.

---

✅ Acceptance Criteria

• The API should correctly expose blockchain-related functionalities.
• Swagger documentation must be available for all endpoints.
• API must handle errors gracefully and provide meaningful responses.
• Unit tests must pass before merging.

[TheRanomial]

Could I be assigned to this?ETA - 30 hours

[TobieTom]

Hola. I'm Tobias. I currently learned Rust and Cairo and am looking to take over this issue. I also have experience with web dev from the projects I handled in uni and would appreciate to add this to my experience pool

[ryzen-xp]

Can I take this from here?

Approach:

1. Implement API endpoints for balance, metadata, and transfers.
2. Use DTOs for validation and ensure proper error handling.
3. Integrate with StarknetService, controller and write unit tests.
4. Generate Swagger documentation.

[onelove-dev]

Hello,

I'd like to help implement the blockchain controller for the StarkNet API endpoints. I've worked extensively with StarkNet and REST API development.

What I would be doing in this task involves:

Building the blockchain controller with:
- Balance checking endpoint with account/token validation
- Token metadata retrieval system
- Secure transfer endpoint with DTO validation
- Integration with existing StarkNet service

Implementation details:
- Request validation using class-validator
- Error handling middleware setup
- Swagger documentation integration
- Unit test coverage with Jest

I can complete this implementation by tomorrow EOD, delivering:

• Fully functional controller with all endpoints
• Complete Swagger documentation
• Test suite covering all scenarios
• Error handling implementation

Relevant experience:

• Built multiple StarkNet integrations
• Strong REST API development background
• Experience with NestJS controllers
• Familiar with blockchain data handling

I can start immediately and provide regular progress updates.

[onelove-dev]

Please, can I be assigned to this?

@Josue19-08

[devJaja]

I'd love to work on this!
I'm a smart contract developer, I can handle this issue

[ryzen-xp]

Hi,
I am proficient Blockchain developer expert in Cairo , Rust and Solidity and also in web development.

Approach:

1. Implement API endpoints for balance, metadata, and transfers.
2. Use DTOs for validation and ensure proper error handling.
3. Integrate with StarknetService, controller and write unit tests.
4. Generate Swagger documentation.