Framino

Framino is a blockchain-powered platform that transforms the hiking and pilgrimage experience by integrating Web3 technology with outdoor adventures. Hikers and pilgrims can discover curated trails, make USDC donations, and receive dynamic NFT badges that track their journey progress and achievements.

The platform supports gasless transactions using account abstraction and Circle Paymaster, making blockchain interactions seamless for all users. Framino also enables on-chain redemption of goods during the journey and provides a secure, verifiable way to mark pilgrimage completion at designated locations like cathedrals. The system is designed to be community-driven, supporting social features, trail validation, and a token economy to incentivize participation and environmental stewardship.

Framino consists of a Next.js frontend (TypeScript, Tailwind CSS, Mapbox for maps) and a Node.js backend (Express.js, TSOA) both hosted on Vercel for unified deployment. The backend exposes REST APIs for NFT minting, redemption, and USDC donations, and interacts with an ERC-1155 smart contract on Arbitrum Sepolia using both Ethers.js v6 and Viem v2.

Account abstraction (EIP-7702) and Circle Paymaster are used to sponsor gas fees, enabling a fully gasless user experience. NFT metadata and images are stored on IPFS for decentralization and tamper-resistance. The frontend integrates wallet connection (MetaMask, WalletConnect, RainbowKit), QR code scanning for trail checkpoints, and a user dashboard for tracking badges and achievements.

The project leverages TSOA for automatic OpenAPI documentation, and uses Biconomy SDK and EIP-2612 permits for advanced token and account management. The architecture is modular, with clear separation between frontend, backend, smart contracts, and storage, allowing for easy expansion and community contributions.