Building an Ethereum app using Redwood.js and Fauna

This tutorial demonstrates building an Ethereum application using Redwood.js and FaunaDB, forking from the Emanator monorepo. It focuses on replacing the original Heroku database with FaunaDB, highlighting Fauna's ACID guarantees and ease of integration with GraphQL.

The tutorial assumes familiarity with Ethereum, Redwood.js, or FaunaDB. Newcomers to Ethereum are directed to the revamped Ethereum Developers page for resources. The project utilizes Superfluid for real-time financial applications within the context of NFT minting and auctions.

Key Steps:

1. Setup: Clone the redwood-eth-with-fauna repository, install dependencies (yarn), and configure environment variables (including your Infura Project ID and Fauna secret API key). A crucial step involves adding a contentHash field to the Auction model in api/prisma/schema.prisma and running database migrations (yarn rw db save redwood-eth-with-fauna && yarn rw db up).

2. Adding Fauna: Install faunadb and graphql-request (yarn workspace api add faunadb graphql-request). The PrismaClient is replaced with a FaunaDB client instance in api/src/lib/db.js and api/src/functions/graphql.js. A new file, api/src/lib/fauna-client.js, is created to manage the Fauna client.

3. GraphQL Schema Integration: A new file, api/src/graphql/fauna-schema-to-import.gql, is created to stitch the three separate schemas together. This schema is then imported into the Fauna database. Subsequently, the three separate schema files (auctions.sdl.js, bids.sdl.js, and web3.sdl.js) are updated to reflect the Fauna schema. Note: Due to Fauna's GraphQL API not supporting custom scalars, some modifications are needed, particularly in api/src/services/auctions/auctions.js, to handle the pastAuctions field and other data inconsistencies. The tutorial provides diffs for these changes, emphasizing the use of FQL (Fauna Query Language) for database interactions.

4. Service Updates: The tutorial details significant modifications to the auctions.js, bids.js, and web3.js service files, replacing Prisma calls with FaunaDB FQL queries. These changes are detailed through diffs, highlighting the transition to Fauna's functional query approach. A final adjustment in web/src/components/AuctionCell/AuctionCell.js addresses a rendering issue.

Conclusion:

After completing these steps and running yarn rw dev, the application should function with FaunaDB as the backend. The tutorial acknowledges two remaining issues: an error message requiring a page refresh after NFT creation, and a rendering problem with the NFT detail page. The author encourages community contributions to address these issues. The complete project is available on GitHub.

The above is the detailed content of Building an Ethereum app using Redwood.js and Fauna. For more information, please follow other related articles on the PHP Chinese website!