Skip to main content
OwnaFarm consists of three layers: frontend, backend, and blockchain.

​
Frontend layer

​
Farmer portal

RouteFunction
/Landing page
/register-farmMulti-step farmer registration
/adminInvoice management

​
Investor app

RouteFunction
/Homepage with active crops
/shopSeed marketplace
/farmPersonal garden view
/leaderboardInvestor rankings
/profileUser stats

​
Backend layer

​
Responsibilities

AreaFunction
User managementProfiles, authentication, KYC
Game stateXP, levels, water points
Document storageFarmer documents to R2
Event indexingSync blockchain events

​
Data stores

StorePurpose
PostgreSQLPrimary database
ValkeyCaching and sessions
Cloudflare R2Document storage

​
Blockchain layer

​
Smart contracts

ContractStandardPurpose
GoldTokenERC-20Platform currency
GoldFaucet—Testnet distribution
OwnaFarmNFTERC-1155Invoice tokens
OwnaFarmVault—Yield reserve

​
Why Mantle

FeatureBenefit
Layer 2Low gas fees
EVM compatibleStandard tooling
Fast finalityQuick confirmations

​
Data distribution

Data typeLocationReason
Financial stateBlockchainImmutable, trustless
User identityDatabasePrivacy, compliance
Game mechanicsDatabaseFlexibility
DocumentsCloud storageSize, access

​
Communication patterns

REST API (JSON)
POST /api/farmers/register
GET  /api/user/profile
POST /api/game/water

WAGMI/Viem (RPC)
READ:  getAvailableInvoices()
WRITE: invest(), harvest()

go-ethereum (RPC)
Event listening
Transaction submission