DEV Community: Timothy Stephen Nenji

Structuring Smart Contract Metadata for Fine Art Provenance on Base

Timothy Stephen Nenji — Wed, 04 Nov 2026 13:25:06 +0000

When launching digital art or tracking physical canvas provenance on EVM-compatible networks like Base, how you structure your ERC-721 or ERC-1155 token metadata determines how wallet apps, secondary marketplaces (like OpenSea), and archival nodes render your work.

As a multidisciplinary visual artist and founder of Iceberg Art Nation, I bridge physical fine art—such as acrylic paintings and pencil portraiture—with decentralized digital assets. In this guide, I’ll walk through the exact metadata architecture, JSON schemas, and smart contract URI configurations used to anchor physical and digital craft on-chain.

1. ERC-721 vs. ERC-1155 for Art Provenance

Choosing between standards depends on the nature of the physical or digital asset:

ERC-721 (Unique 1-of-1 Physicals & Digital Originals): Best suited for 1-of-1 original paintings (e.g., The Golden Valley). Every token ID maps to a unique tokenURI containing distinct attributes, physical dimensions, medium details, and physical signatures.
ERC-1155 (Editions & Merchandise Collections): Best suited for limited-edition prints or digital open editions. Allows batch transfers and reduces gas fees significantly on Layer-2 solutions like Base.

2. Standardizing the Metadata Schema

OpenSea and major ERC standards read metadata as a JSON object hosted on IPFS or Arweave. Here is the structured JSON schema designed to accommodate both digital rendering and physical provenance details:


json
{
  "name": "Cascading Harmony: Emerald Edition #1",
  "description": "Digital provenance record for the original acrylic-on-canvas artwork by Iceberg Art Nation. Includes verified physical dimensions and on-chain signature.",
  "image": "ipfs://QmX.../cascading_harmony_highres.jpg",
  "external_url": "[https://www.saatchiart.com/timothystephennenji](https://www.saatchiart.com/timothystephennenji)",
  "attributes": [
    {
      "trait_type": "Medium",
      "value": "Acrylic on Canvas"
    },
    {
      "trait_type": "Dimensions",
      "value": "12 x 16 inches"
    },
    {
      "trait_type": "Signature",
      "value": "Hand-signed 'IE' (Bottom-Right)"
    },
    {
      "trait_type": "Provenance Hub",
      "value": "Iceberg Art Nation Studio (Jos, Nigeria)"
    },
    {
      "trait_type": "Edition Type",
      "value": "1-of-1 Physical Original"
    },
    {
      "trait_type": "Network",
      "value": "Base L2"
    }
  ]
}

Structuring Smart Contract Metadata for Fine Art Provenance on Base

Timothy Stephen Nenji — Wed, 04 Nov 2026 12:35:10 +0000

Body

1. ERC-721 vs. ERC-1155 for Art Provenance

Choosing between standards depends on the nature of the physical or digital asset:

ERC-721 (Unique 1-of-1 Physicals & Digital Originals): Best suited for 1-of-1 original paintings (e.g., The Golden Valley). Every token ID maps to a unique tokenURI containing distinct attributes, physical dimensions, medium details, and physical signatures.
ERC-1155 (Editions & Merchandise Collections): Best suited for limited-edition prints or digital open editions. Allows batch transfers and reduces gas fees significantly on Layer-2 solutions like Base.

2. Standardizing the Metadata Schema

{
  "name": "Cascading Harmony: Emerald Edition #1",
  "description": "Digital provenance record for the original acrylic-on-canvas artwork by Iceberg Art Nation. Includes verified physical dimensions and on-chain signature.",
  "image": "ipfs://QmX.../cascading_harmony_highres.jpg",
  "external_url": "https://www.saatchiart.com/timothystephennenji",
  "attributes": [
    {
      "trait_type": "Medium",
      "value": "Acrylic on Canvas"
    },
    {
      "trait_type": "Dimensions",
      "value": "12 x 16 inches"
    },
    {
      "trait_type": "Signature",
      "value": "Hand-signed 'IE' (Bottom-Right)"
    },
    {
      "trait_type": "Provenance Hub",
      "value": "Iceberg Art Nation Studio (Jos, Nigeria)"
    },
    {
      "trait_type": "Edition Type",
      "value": "1-of-1 Physical Original"
    },
    {
      "trait_type": "Network",
      "value": "Base L2"
    }
  ]
}

3. Implementing Metadata URIs in Solidity

Here is a minimal Solidity implementation using OpenZeppelin’s ERC-721 base contract deployed on Base. It allows dynamic metadata pointing while securing token authenticity:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

import "@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol";
import "@openzeppelin/contracts/access/Ownable.sol";

contract IcebergArtProvenance is ERC721URIStorage, Ownable {
    uint256 private _nextTokenId;

    event ArtworkMinted(uint256 indexed tokenId, string tokenURI, address owner);

    constructor(address initialOwner) 
        ERC721("Iceberg Art Provenance", "ICEBERG") 
        Ownable(initialOwner) 
    {}

    /**
     * @dev Mints a new artwork token linked to IPFS metadata.
     * @param recipient Address receiving the minted token.
     * @param metadataURI IPFS path to the artwork JSON metadata.
     */
    function mintArtwork(address recipient, string memory metadataURI) public onlyOwner returns (uint256) {
        uint256 tokenId = ++_nextTokenId;
        _safeMint(recipient, tokenId);
        _setTokenURI(tokenId, metadataURI);

        emit ArtworkMinted(tokenId, metadataURI, recipient);
        return tokenId;
    }
}

4. Deploying & Verifying on Base

Host Metadata on IPFS: Upload your high-resolution artwork file and your matching metadata.json to IPFS using Pinata or NFT.Storage.
Deploy to Base Mainnet: Compile using Hardhat or Foundry and target the Base Mainnet RPC ([https://mainnet.base.org](https://mainnet.base.org)).
Verify Contract: Verify the contract source code on BaseScan to ensure public transparency for collectors.

By standardizing metadata attributes directly inside smart contracts, collectors get verified physical provenance, while developer communities see a robust implementation of Web3 asset management.

Explore My Collections

⚡ OpenSea Provenance Hub: Explore Iceberg Art Nation on Base
🖼️ Original Fine Art Gallery: View physical canvas works on Saatchi Art
👕 Merchandise & Wearables: Browse custom apparel on Redbubble

From Canvas to Code: Building a Multidisciplinary Art & Tech Brand as a Solo Creator

Timothy Stephen Nenji — Wed, 04 Nov 2026 11:36:19 +0000

Body

As a visual artist and founder behind Iceberg Art Nation, my day-to-day work spans two worlds that are often treated as completely separate: traditional physical fine art and modern digital architecture.

On one hand, I spend hours mixing acrylics on canvas and working with physical pencils. On the other, I manage e-commerce storefronts, design digital character concepts, deploy smart contract assets across decentralized networks like Base, and experiment with model context protocols (MCP) to manage digital collections.

I'm sharing this breakdown to explore how independent creators can leverage developer tools, Web3 provenance, and smart infrastructure to turn traditional craftsmanship into a scalable, tech-enabled brand.

1. The Fine Art Foundation: Physical Craft & Curation

Every creative venture needs an anchor in genuine craftsmanship. For Iceberg Art Nation, that foundation is built on traditional fine art—ranging from intricate pencil portraiture to large-scale, high-texture acrylic landscape impressionism (such as The Golden Valley and Cascading Harmony).

To reach global collectors who value original physical artwork, maintaining a dedicated gallery presence on platforms like Saatchi Art provides the formal curation, collector trust, and art-world infrastructure necessary for original pieces.

+-------------—-—---------------+
|       Iceberg Art Nation      |
+----------------+—-—-----------+
                 |                               
      +----------+----------+
      |                     |
      v                     v
+--———————-----+ +---————————-—---+
|PHYSICAL CRAFT| |DIGITAL CREATIVE|
|  (Fine Art)  | |   & DEV STACK  |
+--------------+ +----------------+
|• Acrylics    | |• Framer / CMS  |
|• Pencil Works| |• OpenSea (Base)|
|• Saatchi Art | |• Print-onDemand|
+--------------+ +----------------+

2. The Tech Stack: Scaling the Brand

While fine art galleries host original physical works, a modern brand needs an automated, scalable digital layer. Here is how I structure the digital side of Iceberg Art Nation:

Storefront & CMS Architecture: Using modern web builders (Framer, Pineapple Builder, and headless CMS setups) allows me to design high-performance, minimalist gallery spaces that look like Scandinavian art halls rather than standard e-commerce templates.
Web3 Provenance & Smart Contracts: To bridge physical/digital authenticity, I leverage ERC-721 and ERC-1155 standards on the Base network via OpenSea. Storing digital metadata ensures immutable proof of ownership and trackable collection provenance for digital collectibles.
Automated Print-on-Demand (POD): Custom apparel and merchandise are integrated directly into international fulfillment pipelines (Redbubble, TeePublic, Printify), allowing artwork to scale into wearable products globally without local inventory friction.

3. Why Art & Code Belong Together

Building your own brand infrastructure as a creator changes your perspective on modern developer tools. When you understand how APIs connect print fulfillment, how webhooks update order status, or how local AI agents interact with Web3 endpoints, you stop waiting for platforms to build tools for you—you build them yourself.

Explore My Collections & Connect

🖼️ Original Fine Art Gallery: View my physical canvas works on Saatchi Art
⚡ NFT & Digital Provenance: Explore digital collectibles on OpenSea
👕 Merch & Wearable Art: Shop print-on-demand designs on Redbubble

I’d love to hear from developers, designers, and Web3 builders on optimizing independent creator stacks, metadata management, or smooth e-commerce integrations!