Implement ERC-1155 Token Transfers

[Josue19-08]

📌 Issue: Implement ERC-1155 Token Transfers

🔹 Description

Enable the API to execute NFT and fungible token transfers between accounts on StarkNet Testnet using the safeTransferFrom method from the ERC-1155 contract. This will allow users to send assets securely.

---

📂 Project Structure

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

---

🛠️ Tasks

• Implement transferToken(from, to, tokenId, amount) using the safeTransferFrom function from the contract.
• Validate input parameters (wallet addresses, token ID, amount).
• Implement error handling for:
  • Insufficient token balance.
  • Invalid recipient address.
  • Transaction failures on the blockchain.
• Implement logging for debugging failed transactions.
• Write unit tests to validate:
  • Successful token transfer between accounts.
  • Handling invalid addresses or token IDs.
  • Checking blockchain confirmation for transactions.

---

✅ Acceptance Criteria

• Tokens should be transferable between accounts.
• API should return a transaction hash upon successful transfer.
• Transactions should be visible on StarkScan after execution.
• Unit tests must pass before merging.