Topics

#akash #devops #devops-platform #devops-tools #docker #mongodb #web3

Language breakdown

No language data available.

▸ Files click to expand

README

)

DevDapp Season 1

Welcome to DevDapp! The GitHub Incentives Layer built on RAIRprotocol. With DevDapp you can earn tokens for contributing to our open-source! Connect your GitHub. Track Contributions. Earn RAIR + partner tokens.

How DevDapp Works

Log in with GitHub: Pop over to DevDapp.com and sign in with your GitHub account. This sets up your profile and tracks your progress.
Complete your first task: Watch how-to videos in the tasks section on DevDapp.
Submit your work: Create a GitHub issue with your proof of completion (the tutorial will show you how).
Get verified and earn: If it’s all good, you’ll earn a completion label, and your profile will level up!

Rewards

Season 1 rewards are 50,000,000 RAIR + bonus partner tokens!! Season 1 starts now. Join early to have more time to complete tasks.

Help

If you're having trouble Season 1 Tasks folder has all needed info.

Discord

‼️ Come join us on Discord! ‼️

Our community is where we post the important announcements first, and where you can get real-time support.

RAIR dApp - Comprehensive Integration Master List

A list of all the underlying technologies that power RAIRprotocol - so much to learn good thing we have AI!

1. Blockchain Infrastructure

Essential blockchain connectivity and interaction technologies

| ID | Name | Type | Description | Importance | Environment Variables | |-----|----------------------------------------------------------------------|---------|---------------------------------------------------|-------------------------------------------------------|-----------------------------------------| | 1.1 | Ethers.js | Library | JavaScript library for Ethereum blockchain operations | Core technology for contract calls, transactions, and wallet integration | N/A (Library) | | 1.2 | Alchemy SDK | SDK | Enhanced API access to multiple blockchain networks | Provides reliable RPC capabilities and advanced blockchain data access | ALCHEMYAPI_KEY | | 1.3 | Wagmi | Hooks | React hooks library for Ethereum | Simplifies blockchain state management in the frontend UI | N/A (Library) | | 1.4 | Viem | Library | TypeScript interface for Ethereum interactions | Alternative to Ethers.js for blockchain operations | N/A (Library) | | 1.5 | Web3Auth | Auth | Non-custodial wallet authentication | Simplifies wallet onboarding with social logins | Requires project setup in Web3Auth dashboard | | 1.6 | Account Abstraction | SDK | Advanced wallet features by Alchemy | Enables gasless transactions and smart contract wallets | Uses ALCHEMYAPI_KEY | | 1.7 | @metamask/providers | Library | MetaMask integration | Connects dApp to MetaMask wallet | N/A (Library) | | 1.8 | @walletconnect/sign-client | Protocol | Multi-wallet connector | Provides broader wallet compatibility beyond MetaMask | Requires WalletConnect project ID | | 1.9 | @metamask/onboarding | Library | Guides users to install MetaMask | Assists users in wallet setup | N/A (Library) |

2. Storage Solutions

Data storage across centralized and decentralized systems

| ID | Name | Type | Description | Importance | Environment Variables | |-----|-------------------------------------------------------|--------------|------------------------------------------|-----------------------------------------------------|----------------------------------------------------| | 2.1 | MongoDB | Database | Primary persistent data store | Stores user data, NFT metadata, and application state | MONGOURI, MONGOURILOCAL, MONGODBHOSTNAME, MONGODBNAME | | 2.2 | Redis | Cache | In-memory data store | Handles session management and performance caching | REDISHOST, REDIS_PORT | | 2.3 | IPFS | Decentralized | Content-addressed storage | Stores NFT media and provides decentralized file access | IPFSSERVICE, IPFSGATEWAY, IPFSAPI | | 2.4 | Pinata | Service | IPFS pinning service | Ensures IPFS content availability and persistence | PINATAKEY, PINATASECRET, PINATAGATEWAY | | 2.5 | GCP Storage | Cloud | Google Cloud Storage | Stores media files, backups, and centralized content | GCPPROJECTID, GCPIMAGEBUCKETNAME, GCPVIDEOBUCKETNAME, GCPGATEWAY, GCP_CREDENTIALS | | 2.6 | AWS S3 | Cloud | Amazon S3 object storage | Alternative file storage and backup solution | AWSACCESSKEYID, AWSSECRETACCESS_KEY | | 2.7 | Filebase | Service | S3-compatible decentralized storage | Additional decentralized storage option | FILEBASEACCESSKEY, FILEBASESECRETACCESSKEY, FILEBASE_BUCKET |

3. Backend Services

Server-side components and utilities

| ID | Name | Type | Description | Importance | Environment Variables | |------|-------------------------------------------------------|-------------|-----------------------------------------|-------------------------------------------------|----------------------------------------| | 3.1 | Express | Framework | Web server and API framework | Provides API endpoints, routing, and middleware infrastructure | N/A (Framework) | | 3.2 | Mongoose | ODM | MongoDB object modeling | Handles database schema, validation, and operations | Uses MongoDB variables | | 3.3 | Socket.IO | Realtime | WebSocket communication | Enables live updates, notifications, and event handling | N/A (Library) | | 3.4 | Agenda | Scheduler | Job scheduling for Node.js | Manages background tasks and blockchain synchronization | SYNCCONTRACTREPEATEVERY, SYNCCONTRACTTASK_INTERVAL | | 3.5 | Winston | Logging | Structured logging utility | Provides application logging and monitoring | LOGLEVEL, MONGOLOGCOLLECTION | | 3.6 | Morgan | Middleware | HTTP request logger | Tracks API requests for debugging | N/A (Middleware) | | 3.7 | Multer | Middleware | File upload handling | Processes user-uploaded files | N/A (Middleware) | | 3.8 | Body Parser | Middleware | Request body parsing | Handles JSON and form data in requests | N/A (Middleware) | | 3.9 | Swagger | Documentation | API documentation | Provides interactive API documentation | N/A (Documentation) | | 3.10 | Node-fetch | Utility | Server-side HTTP requests | Facilitates API calls from backend services | N/A (Utility) | | 3.11 | Cors | Middleware | Cross-origin resource sharing | Enables frontend/backend communication | N/A (Middleware) | | 3.12 | Nanoid | Utility | ID generation | Creates unique identifiers for records | N/A (Utility) | | 3.13 | Axios | HTTP Client | Promise-based HTTP client | Alternative for making API requests | N/A (Library) | | 3.14 | Lodash | Utility | JavaScript utility library | Simplifies data manipulation and operations | N/A (Utility) |

4. Frontend Framework

User interface foundation

| ID | Name | Type | Description | Importance | Environment Variables | |------|-------------------------------------------------------|-------------|---------------------------------------|--------------------------------------------|-------------------------------| | 4.1 | React | Framework | UI component library | Core frontend framework | N/A (Framework) | | 4.2 | Redux Toolkit | State | Global state management | Manages application state and data flow | N/A (Library) | | 4.3 | React Router | Navigation | Client-side routing | Handles page transitions and navigation | N/A (Library) | | 4.4 | Vite | Build | Development server and bundler | Provides fast development and optimized builds | Frontend env vars prefixed with VITE | | 4.5 | TypeScript | Language | Typed JavaScript | Ensures type safety and improved developer experience | N/A (Language) | | 4.6 | Styled Components | CSS | Component-level styling | Enables modular, maintainable UI styling | N/A (Library) | | 4.7 | MUI Material | Components | React UI component library | Offers pre-designed UI elements | N/A (Library) | | 4.8 | Bootstrap | CSS | Responsive design framework | Facilitates layout and responsive design | N/A (Library) | | 4.9 | Zustand | State | Lightweight state management | Alternative to Redux for simpler state needs | N/A (Library) | | 4.10 | React Hook Form | Forms | Form management in React | Simplifies form handling and validation | N/A (Library) |

5. Media & Content Components

Rich media handling and display

| ID | Name | Type | Description | Importance | Environment Variables | |------|-------------------------------------------------------|-------------|---------------------------------------|--------------------------------------------|-----------------------| | 5.1 | Video.js | Player | Video playback library | Core for NFT video content playback | N/A (Library) | | 5.2 | React Player | Component | Media player component | Provides flexible media embed options | N/A (Component) | | 5.3 | React Dropzone | Upload | File upload UI | Enables drag-and-drop file uploads | N/A (Component) | | 5.4 | React Webcam | Media | Camera access component | Facilitates live video capture | N/A (Component) | | 5.5 | React Multi Carousel | UI | Content carousel | Showcases multiple items in scrollable format | N/A (Component) | | 5.6 | React Modal | UI | Dialog windows | Handles user interactions and confirmations | N/A (Component) | | 5.7 | React Slick | UI | Carousel alternative | Additional option for content display | N/A (Component) | | 5.8 | React Tabs | UI | Tabbed interfaces | Organizes content in accessible tabs | N/A (Component) | | 5.9 | React Share | Social | Social sharing buttons | Enables content sharing on social platforms | N/A (Component) | | 5.10 | Reactjs Popup | UI | Simple popup component | Lightweight alternative for user feedback | N/A (Component) | | 5.11 | React Hot Toast | UI | Toast notifications | Provides unobtrusive user notifications | N/A (Component) |

6. Security & Authentication

Application protection and access control

| ID | Name | Type | Description | Importance | Environment Variables | |------|-------------------------------------------------------|-------------|---------------------------------------|--------------------------------------------|-------------------------------| | 6.1 | JWT | Auth | JSON Web Token authentication | Secures API access with token-based auth | JWTSECRET | | 6.2 | Express Session | Session | User session management | Maintains persistent user sessions | SESSIONSECRET, SESSION_TTL | | 6.3 | Lusca | Security | Web vulnerability protection | Guards against CSRF and XSS attacks | N/A (Middleware) | | 6.4 | Yoti | Identity | Identity verification | Provides enhanced user identity verification | YOTICLIENT_ID | | 6.5 | Rate Limit | Middleware | Request throttling | Prevents API abuse and DoS attacks | RATELIMIT_MINUTE | | 6.6 | CORS | Middleware | Cross-origin resource sharing | Controls cross-domain access to APIs | N/A (Middleware) | | 6.7 | Cookie Parser | Middleware | Cookie handling | Processes cookies for auth and preferences | N/A (Middleware) | | 6.8 | Connect-Redis | Session | Redis session store | Integrates Redis with Express sessions | Uses Redis variables |

7. Wallet Integration

Blockchain wallet connectivity

| ID | Name | Type | Description | Importance | Environment Variables | |------|-------------------------------------------------------|-------------|---------------------------------------|--------------------------------------------|-------------------------------| | 7.1 | MetaMask | Wallet | Browser extension wallet | Primary user wallet connection method | N/A (Client-side) | | 7.2 | WalletConnect | Protocol | Multi-wallet connector | Enables broader wallet compatibility | Requires WalletConnect project ID | | 7.3 | Web3Auth | Auth | Social login for wallets | Simplifies wallet authentication experience | Requires Web3Auth credentials | | 7.4 | Alchemy AA | SDK | Account abstraction | Enables smart contract wallets and advanced features | Uses ALCHEMYAPI_KEY |

8. Development & DevOps

Development workflow and quality tools

| ID | Name | Type | Description | Importance | Environment Variables | |------|-------------------------------------------------------|-------------|---------------------------------------|--------------------------------------------|-------------------------------------------| | 8.1 | ESLint | Linter | Code quality enforcement | Maintains code standards and prevents errors | N/A (Dev tool) | | 8.2 | Prettier | Formatter | Code formatting | Ensures consistent code style | N/A (Dev tool) | | 8.3 | Husky | Git Hooks | Pre-commit tasks | Automates code quality checks | N/A (Dev tool) | | 8.4 | Nodemon | Dev | Server auto-restart | Improves development workflow efficiency | N/A (Dev tool) | | 8.5 | Docker | Container | Application containerization | Ensures deployment and environment consistency | N/A (Infrastructure) | | 8.6 | Vault | Security | Secret management | Securely manages application credentials | VAULTURL, VAULTAPPROLEID, VAULTAPPROLESECRET_ID | | 8.7 | Dotenv | Config | Environment variables | Manages configuration across environments | N/A (Dev tool) |

9. Monitoring & Analytics

Application health and user insights

| ID | Name | Type | Description | Importance | Environment Variables | |------|-------------------------------------------------------|-------------|---------------------------------------|--------------------------------------------|-------------------------------------------| | 9.1 | Sentry | Monitoring | Error tracking | Ensures application reliability and issue detection | SENTRYDSN, VITESENTRYENABLED, VITESENTRYIOENDPOINT, VITESENTRYIOTRACERATE, VITESENTRY_RELEASE | | 9.2 | Google Analytics | Analytics | Usage metrics | Tracks user behavior and interactions | VITEGOOGLEANALYTICS, VITEGA_NAME | | 9.3 | Custom Events | Tracking | Event monitoring | Provides flexible interaction tracking | N/A (Implementation-specific) | | 9.4 | React GA | Analytics | Google Analytics for React | Integrates GA specifically with React | Uses Google Analytics variables |

Note: Custom Events lacks a specific GitHub repository as it’s implementation-specific; no URL is provided.

10. Microservices Architecture

Core services that compose the application

| ID | Name | Type | Description | Importance | Environment Variables | |-------|-------------------------------------------------------|-------------|---------------------------------------|--------------------------------------------|-------------------------------| | 10.1 | rairnode | Service | Main backend API service | Provides primary API endpoints and business logic | Multiple (see docker-compose) | | 10.2 | blockchain-networks | Service | Blockchain data synchronization | Syncs data from multiple blockchain networks | Multiple (see docker-compose) | | 10.3 | media-service | Service | Media processing service | Handles media file processing and delivery | MEDIASERVICEPORT, BASERAIRNODE_URL + storage vars | | 10.4 | rair-redis | Service | In-memory data store | Manages sessions and caching | Redis configuration | | 10.5 | minting-network | Service | Frontend dApp | User-facing application for NFT minting | Frontend-specific variables |

Note: Some microservices (blockchain-networks, media-service, minting-network) lack public GitHub repositories; no URLs are provided where unavailable.

11. Blockchain Networks

Supported blockchain networks in the system

| ID | Name | Type | Description | Importance | Environment Variables | |-------|-------------------------------------------------------|-------------|---------------------------------------|--------------------------------------------|-------------------------------------------| | 11.1 | Ethereum Mainnet | Network | Production Ethereum network | Primary Ethereum blockchain environment | ETHEREUMMAINNETRPC, ETHEREUMMAINNETFACTORYADDRESS, ETHEREUMMAINNETMINTER_ADDRESS | | 11.2 | Ethereum Sepolia | Network | Ethereum testnet | Testing environment for Ethereum | ETHEREUMTESTNETSEPOLIARPC, SEPOLIAFACTORYADDRESS, SEPOLIAMINTERADDRESS, etc. | | 11.3 | Polygon/Matic Mainnet | Network | Production Polygon network | Scalable production environment | MATICMAINNETRPC, MATICMAINNETFACTORYADDRESS, MATICMAINNETMINTER_ADDRESS, etc. | | 11.4 | Polygon/Matic Mumbai | Network | Polygon testnet | Testing environment for Polygon | MATICTESTNETRPC, MATICMUMBAIFACTORYADDRESS, MATICMUMBAIMINTER_ADDRESS, etc. | | 11.5 | Binance Smart Chain | Network | Production BSC network | Alternative production blockchain | BINANCEMAINNETRPC, BINANCEMAINNETFACTORYADDRESS, BINANCEMAINNETMINTER_ADDRESS, etc. | | 11.6 | Binance Testnet | Network | BSC testnet | Testing environment for BSC | BINANCETESTNETRPC, BINANCETESTNETFACTORYADDRESS, BINANCETESTNETMINTER_ADDRESS, etc. | | 11.7 | Base | Network | Production Base network | Ethereum L2 scaling solution | BASEMAINNETRPC, BASEDIAMONDFACTORYADDRESS, BASEDIAMONDMARKETPLACE_ADDRESS | | 11.8 | Astar | Network | Production Astar network | Polkadot parachain integration | ASTARMAINNETRPC, ASTARDIAMONDFACTORYADDRESS, ASTARDIAMONDMARKETPLACE_ADDRESS |

12. External Services

Third-party integrations

| ID | Name | Type | Description | Importance | Environment Variables | |-------|-------------------------------------------------------|-------------|---------------------------------------|--------------------------------------------|-------------------------------| | 12.1 | Alchemy | Blockchain | Enhanced RPC provider | Provides reliable blockchain connectivity | ALCHEMYAPI_KEY | | 12.2 | Pinata | Storage | IPFS pinning service | Ensures decentralized content persistence | PINATAKEY, PINATASECRET, PINATAGATEWAY | | 12.3 | Google Cloud Platform | Cloud | Cloud services provider | Hosts various infrastructure components | GCPPROJECTID, GCPCREDENTIALS, etc. | | 12.4 | Sentry.io | Monitoring | Error tracking service | Tracks application errors and performance | SENTRYDSN | | 12.5 | Zoom | Communication | Video meetings integration | Facilitates video communication features | ZOOMAPIKEY, ZOOMAPISECRET, ZOOMMEETING_ID | | 12.6 | Yoti | Identity | ID verification service | Provides KYC and identity verification | YOTICLIENT_ID |

RAIRprotocol Master API List

Authentication

Endpoints related to user authentication, including wallet sign-in and session management.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /auth/get_challenge | POST | Generate challenge for wallet sign-in| None | Initiates web3 authentication flow | | /auth/login | POST | Login with wallet signature | None | Core authentication endpoint | | /auth/loginSmartAccount | POST | Login with smart account signature | None | Support for smart contract wallets | | /auth/logout | GET | Logout user session | User Session | Session management | | /auth/me | GET | Get current user details | User Session | Session verification | | /auth/unlock | POST | Unlock media with session | User Session | Content access management | | /auth/stream/out | GET | End media stream authorization | User Session | Media streaming control |

User Management

Endpoints for managing user profiles and related administrative tasks.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /users/list | GET | List all users | Admin | User management for admins | | /users/export | GET | Export users as CSV | Admin | Data export functionality | | /users/verify-age | POST | Verify user age with Yoti | User Session | Age verification compliance | | /users/:publicAddress | GET | Get user by wallet address | None | Public profile retrieval | | /users/:publicAddress | PATCH | Update user profile | User Session | Profile management |

NFT Management

Endpoints for creating, retrieving, and managing non-fungible tokens (NFTs).

| Endpoint | Method | Description | Authentication | Importance | |-------------------------------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /nft | POST | Create tokens via CSV | Admin | Bulk token creation | | /nft | GET | Get current user's tokens | User Session | Token discovery | | /nft/:userAddress | GET | Get tokens by user address | None | Profile token view | | /nft/csv/sample | GET | Get metadata CSV sample | None | Help for token creation | | /nft/pinningMultiple | POST | Pin multiple token metadata to IPFS | User Session | Token metadata persistence | | /nft/network/:networkId/:contract/:product | GET | Get tokens for product | None | Token discovery | | /nft/network/:networkId/:contract/:product/numbers | GET | Get token numbers | None | Token ID enumeration | | /nft/network/:networkId/:contract/:product/attributes | GET | Get product attributes | None | Metadata attribute discovery | | /nft/network/:networkId/:contract/:product/files | GET | Get files for product | None | Product content discovery | | /nft/network/:networkId/:contract/:product/files/:token | GET | Get files for token | None | Token content discovery | | /nft/network/:networkId/:contract/:product/offers | GET | Get offers for product | None | Product offer discovery | | /nft/network/:networkId/:contract/:product/locks | GET | Get locked offers for product | None | Locked offer discovery | | /nft/network/:networkId/:contract/:product/token/:token | GET | Get single token | None | Detailed token info | | /nft/network/:networkId/:contract/:product/token/:token | POST | Update token metadata | User Session | Metadata management | | /nft/network/:networkId/:contract/:product/token/:token/pinning | POST | Pin single token metadata | User Session | IPFS persistence |

Tokens

Endpoints for retrieving information about tokens (potentially including both fungible and non-fungible tokens).

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /tokens | GET | Get all tokens | None | Token discovery | | /tokens/:token | GET | Get token by number | None | Token lookup | | /tokens/id/:id | GET | Get token by ID | None | Token lookup by database ID |

Contract Management

Endpoints for managing smart contracts and their associated data.

| Endpoint | Method | Description | Authentication | Importance | |-----------------------------------------------|--------|--------------------------------------|---------------------|---------------------------------| | /contracts | GET | Get all contracts | None | Contract discovery | | /contracts/factoryList | GET | Get contracts for factory | User Session | Factory contract discovery | | /contracts/my | GET | Get user's contracts | User Session | User's contract discovery | | /contracts/full | GET | Get full contract list | None | Enhanced contract discovery | | /contracts/network/:networkId/:contractAddress | GET | Find contract by network and address | None | Contract lookup | | /contracts/network/:networkId/:contractAddress/products | GET | Get products for contract | None | Contract product discovery | | /contracts/network/:networkId/:contractAddress/offers | GET | Get offers for contract | None | Contract offer discovery | | /contracts/import | POST | Import external contract | Admin + Super Admin | Contract importing | | /contracts/:id | GET | Get contract by ID | None | Contract details | | /contracts/:id | PATCH | Update contract | Admin + Super Admin | Contract management |

File Management

Endpoints for managing media files and their metadata.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|---------------------|---------------------------------| | /files/update/:mediaId | PATCH | Update media file | User Session + Owner| Content management | | /files/remove/:mediaId | DELETE | Delete media file | User Session + Owner| Content deletion | | /files/list | GET | List media files | None | Content discovery | | /files/byId/:id | GET | Get file by ID | None | File lookup | | /files/byId/:id | PUT | Update file | User Session + Owner| File management | | /files/byCategory/:id | GET | Get files by category | None | Category-based discovery | | /files/forToken/:id | GET | Get files for token | None | Token file lookup | | /files/categories | GET | List file categories | None | Category discovery | | /files/:id/unlocks | GET | Get file unlock offers | None | File access management | | /files/:id/unlocks | POST | Create file unlock offer | User Session + Owner| File access management | | /files/:id/unlocks | DELETE | Remove file unlock offer | User Session + Owner| File access management |

Transactions

Endpoints for processing user transactions.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /transactions/:network/:hash | POST | Process user transaction | User Session | Transaction recording and processing |

Product Management

Endpoints for managing products within the platform.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /products | GET | Get all products | None | Product discovery | | /products/user/:userAddress | GET | Get products by user | None | User-specific products | | /products/:id | GET | Get product by ID | None | Product lookup | | /products/:id | POST | Set product banner | None | Product customization |

Credits and Payments

Endpoints for managing user credits and withdrawals.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /credits/:blockchain/:tokenAddress | GET | Get user credits | User Session | Balance checking | | /credits/withdraw | POST | Generate withdraw request | User Session | Fund withdrawal |

Settings & Configuration

Endpoints for managing server and application settings.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /settings | GET | Get server settings | None | System configuration | | /settings/blockchain | POST | Set blockchain setting | Super Admin | Blockchain configuration | | /settings/appLogo | POST | Set application logo | Admin | Branding | | /settings/theme | GET | Get theme settings | None | UI customization | | /settings/featured-collection| GET | Get featured collection | None | Homepage featured content |

Analytics & Reports

Endpoints for retrieving analytics data and reports.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /analytics/:mediaId | GET | Get analytics data | User Session | Performance tracking | | /analytics/:mediaId/csv | GET | Get analytics CSV report | User Session | Data export |

Search

Endpoints for performing searches across the platform.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /search/:textParam | GET | Global search | None | Content discovery | | /search/:textParam/all | GET | Expanded global search | None | Enhanced discovery |

Notifications

Endpoints for managing user notifications.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /notifications | GET | List notifications | User Session | User notifications | | /notifications/:id | GET | Get single notification | User Session | Notification details | | /notifications | PUT | Mark notifications as read | User Session | Notification management | | /notifications | DELETE | Delete notifications | User Session | Notification management |

Favorites

Endpoints for managing user favorites.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /favorites | POST | Create favorite | User Session | User preferences | | /favorites | GET | Get user favorites | User Session | User saved items | | /favorites/:address | GET | Get favorites of address | None | Public favorites | | /favorites/:id | DELETE | Delete favorite | User Session | Favorite management |

Uploads

Endpoints for uploading and validating files.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /upload/validate | GET | Validate media data | None | Content validation | | /upload | POST | Upload file | None | File upload | | /upload/token | GET | Get upload token | None | Upload authorization |

Resales & Secondary Market

Endpoints for managing resale offers and secondary market transactions.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /resales/open | GET | Get open resales | None | Secondary market discovery | | /resales/create | POST | Create resale offer | User Session | Secondary market listing | | /resales/:id | PATCH | Update resale offer | User Session | Offer management | | /resales/:id | DELETE | Delete resale offer | User Session | Offer removal | | /resales/:id/purchase | POST | Generate purchase request | User Session | Secondary market purchase |

Offers

Endpoints for managing offers across the platform.

| Endpoint | Method | Description | Authentication | Importance | |--------------------------------|--------|--------------------------------------|----------------|---------------------------------| | /offers | GET | Get all offers | None | Offer discovery | | /offers/:id | PATCH | Update offer data | Admin | Offer management |

🔗 More in this category