The Artisan is a RWA marketplace where users can buy fractionalized shares of luxury assets backed by Metaplex's Core NFT's. With our custom Solana Program, Artisan Protocol, we are able to ensure all regulatory compliances are met while providing access to Luxury Assets at an affordable price.
The Artisan is a next-generation marketplace that bridges traditional luxury assets with blockchain technology. Our platform enables fractional ownership of high-value assets through a combination of regulatory-compliant NFTs and user-friendly interfaces.
The application is built using a modern tech stack:
- Next.js 14: App Router architecture for server-side rendering and optimal performance
- TypeScript: For type-safe development
- TailwindCSS: For responsive and maintainable styling
- Radix UI: For accessible component primitives
- Apollo Client: For efficient GraphQL data management
- Zustand & Jotai: For state management
- React Three Fiber: For 3D asset visualization
The platform utilizes several backend services:
- MongoDB: For user data and asset metadata storage
- AWS S3: For asset image and media storage
- GraphQL API: For efficient data querying and mutations
- Stripe: For traditional payment processing
- Solana Integration: Built with @solana/web3.js and @coral-xyz/anchor
- Web3Auth: For seamless web2 to web3 user onboarding
- Metaplex: For NFT standard compliance and marketplace integration
- Custom Solana Program to facilitate minting and distribution of Metaplex Core NFTs
buyflow.mp4
- Custom off-chain Database to manage asset and user details necessary for compliance
dashboard.mp4
- Access Luxury Collections to purchase, trade, and sell fractions of available assets
marketplace.mp4
- Track your assets via an intuitive User Dashboard
- Refer friends to earn points and rewards
Use your Email as a wallet and pay using Stripe or Crypto. With Web3Auth integration, users can easily access their Artisan Profile from any browser and while securely maintaining their wallet. With this feature we aim to make the transition to The Artisan simple for Web 2 native investors.
web3auth.mp4
Not familiar with crypto? No problem! Our custom Solana Program utilizes the ED25519_PROGRAM_ID to securely process a Stripe Checkout session to verify purchase and bypass the standard token transfer.
Under the hood our program checks for specific signers and messages to verify the transaction is legit and processed.
| Cluster | Program Id |
|---|---|
| Localnet | s8TwaQ8iKA4NPRgeSEGJfajD4hZAvriK5xisz82yBbU |
| Devnet | s8TwaQ8iKA4NPRgeSEGJfajD4hZAvriK5xisz82yBbU |
| Mainnet | coming soon |
Our Solana Program is currently deployed on Devnet and under testing within our community. Our aim is to launch on mainnet by 2025.
The custom program uses a variation of accounts to faciliate all actions. With the Protocol account using Metaplex Core's OracleValidation we can secure the protocol with one function call, rendering it useless in the case of a breach.
The Artisan Protocal is strategically structured in a modular way to ensure proper functionality in a secure manner. By breaking down the actions into a scope based role, we are able to easily upgrade the program without requiring a total refactor.
With our Marketplace Listing functionality we are able to create an in-house marketplace for users to resell their fractions, allowing us to further use Metaplex Core for royalty collections and ensure buyers are adhering to all legal rules.
With Metaplex Core we are able to dynamically create any Luxury Asset into a fractionalized RWA, and with plugins we can ensure KYC has been completed when user's approach the legal limit. When a user buys a fraction they are minting from the Object's Metaplex's verified collection, allowing us to not onlly resell on our in-house marketplace, but in 3rd parties such as Tensor and MagicEden.
-
Prerequisites
- Node.js 18+
- pnpm (recommended) or npm
- Solana CLI tools
- MongoDB instance
-
Environment Setup
cp .env.example .env.local # Configure your environment variables -
Installation
pnpm install
-
Development
pnpm dev # Start development server pnpm build # Production build pnpm start # Start production server pnpm lint # Run linting pnpm format # Format code
/app/*- Next.js 14 app router pages and layouts/components/*- Reusable UI components/hooks/*- Custom React hooks/providers/*- Context providers/lib/*- Utility functions and configurations/types/*- TypeScript type definitions/graphql/*- GraphQL schemas and operations
The application uses a simplified authentication architecture centered around the Para SDK:
The authentication system is built around a centralized React Context provider (Para.tsx) that:
- Initializes the Para SDK on the client side
- Manages authentication state (tokens, sessions)
- Provides authentication methods to the entire application
- Renders the Para authentication modal
This approach offers several advantages:
- Centralized State Management: Single source of truth for authentication
- Simplified Component Access: Easy access to authentication state via the
usePara()hook - Reduced Bundle Size: Direct SDK initialization without unnecessary abstractions
- Improved Performance: Optimized loading of Para SDK components
The Para provider integrates with existing authentication stores through bridge hooks, allowing for a gradual transition to the simplified architecture without breaking existing functionality.
The application uses iron-session for secure, stateless, cookie-based sessions. This implementation provides several benefits:
- Secure: The session data is encrypted and sealed using Iron, which provides cryptographic guarantees.
- Stateless: No server-side session storage is required, reducing complexity and infrastructure needs.
- Simple API: Easy to use with both API routes and server components.
To enable the authentication system, you need to set the following environment variable:
SECRET_COOKIE_PASSWORDThis password is used to encrypt the session cookies. It should be at least 32 characters long for security.
-
User Authentication
- Email/Social login via Web3Auth
- Wallet connection options
- KYC verification flow
-
Asset Management
- Asset creation and verification
- Fractionalization process
- Marketplace listing
-
Purchase Flows
- Stripe payment integration
- Crypto payment processing
- Fraction minting and distribution
-
Security Considerations
- Multi-signature requirements
- KYC/AML compliance
- Regulatory checks
- Renato Capizzi - CEO & Founder
- Leonardo Donatacci - CTO and Metaplex Community Dev
- Matt Weichel - Lead Developer
See the LICENSE.md file for details.
updated: 10.5.2025