ブロックチェーンとPinata IPFSを使用したデジタル文化財管理システムの試作

本書の目的 デジタル文化財の管理において、「真正性の保証」と「来歴情報の永続的な記録」は極めて重要な課題です。博物館や美術館が所蔵する文化財のデジタルデータは、複製・改ざんが容易であり、従来の中央集権的なデータベースでは長期的な信頼性を担保することが難しい場面があります。 本書では、ブロックチェーン技術とIPFS（InterPlanetary File System）を組み合わせることで、デジタル文化財の管理システムを試作した過程を記録しています。具体的には、文化財のデジタル画像をNFT（Non-Fungible Token）として登録し、その来歴情報をブロックチェーン上に記録するシステムを構築します。 なぜブロックチェーンなのか デジタル・ヒューマニティーズの分野では、文化財のデジタルアーカイブが世界中で進んでいます。しかし、デジタルデータには以下のような課題があります。 改ざん耐性: デジタルデータは容易にコピー・変更が可能であり、オリジナルと複製の区別が困難 来歴追跡: 文化財の所有履歴・修復履歴・展示履歴などの来歴（provenance）情報を信頼性高く記録する仕組みが必要 永続性: 特定の機関やサーバーに依存しないデータ保存が求められる 相互運用性: 異なる機関間でデータを共有・検証できる標準的な仕組みが必要 ブロックチェーンは、これらの課題に対して以下の利点を提供します。 不変性: 一度記録されたデータは改ざんが極めて困難 透明性: すべての取引履歴が公開台帳上で検証可能 分散性: 中央管理者なしにデータの整合性を保証 スマートコントラクト: 文化財の貸出・返却などのルールをプログラムとして実装可能 システムの全体像 本システムは、以下の技術スタックで構成されています。 ┌ │ │ │ ├ │ │ │ │ ├ │ ├ │ │ │ └ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ - - ─ - - - ─ ─ - - ─ ─ ─ ─ ─ ─ ─ ウ 文 ─ E E 履 ─ ─ 画 N ─ ─ ォ 化 ─ R R 歴 ─ ─ 像 F ─ ─ レ 財 ─ C C 記 ─ ─ デ T ─ ─ ッ の ─ 7 4 録 ─ ─ ー メ ─ ─ ト 登 ─ ス 2 9 : ─ ─ タ タ ─ ─ 接 録 ─ マ 1 0 ─ ─ の デ ─ ─ フ 続 ・ ─ ー （ 7 イ ─ ─ P 分 ー ─ ─ ロ （ 閲 ─ ト N : ベ ─ ─ i 散 タ ─ ─ ン M 覧 ─ コ F ン ─ ─ n 保 （ ─ ─ ト e ・ ─ ン T レ ト ─ E ─ a 存 J ─ ─ エ t レ ─ ト ） ン ロ ─ t ─ t S ─ ─ ン a ン ─ ラ : タ グ ─ h ─ a O ─ ─ ド M タ ─ ク ル ─ e ─ N ─ ─ （ a ル ─ ト 文 機 ─ r ─ I ） ─ ─ N s U ─ （ 化 能 ─ e ─ P の ─ ─ e k I ─ S 財 ─ u ─ F 保 ─ ─ x ─ o ト ─ m ─ S 存 ─ ─ t + ─ l ー ─ ─ ─ ─ . ─ i ク ─ S ─ ─ ─ j w ─ d ン ─ e ─ ─ ─ s a ─ i ─ p ─ ─ ─ ） g ─ t ─ o ─ ─ ─ m ─ y ─ l ─ ─ ─ i ─ ） ─ i ─ ─ ─ ） ─ ─ a ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ テ ─ ─ ─ ─ ─ ス ─ ─ ─ │ ─ ─ ト ─ ─ ─ ─ ─ ネ ─ ─ ─ ─ ─ ッ ─ ─ ─ ─ ─ ト ─ ─ ─ ─ │ ─ ─ │ ─ ─ │ ─ │ │ ─ ─ │ ─ ─ │ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │ ─ ─ ─ ─ ─ ─ ─ ┐ ┤ ┤ ┤ ┘ │ 使用技術の概要 技術 用途 バージョン Next.js フロントエンドフレームワーク 14.x Solidity スマートコントラクト言語 0.8.20 Hardhat 開発・テスト・デプロイ環境 2.x ethers.js Ethereumライブラリ v6 wagmi Reactフック for Ethereum 2.x Pinata IPFS ピンニングサービス V3 API Sepolia Ethereumテストネット - 各章の構成 本書は以下の流れで、段階的にシステムを構築していきます。 ...

NFTによるデジタル文化財の表現 デジタル文化財をブロックチェーン上で管理するために、ERC721規格のNFT（Non-Fungible Token）を使用します。各文化財は一意のトークンとして発行され、その所有権・メタデータ・画像データがブロックチェーンとIPFS上に記録されます。 本章では、以下の3つのステップでNFT対応を実装します。 Solidityによるスマートコントラクトの作成 Pinata IPFSを使用したメタデータと画像の保存 ミンティング（発行）フローの実装 ERC721コントラクトの実装 OpenZeppelinのERC721をベースに、文化財管理に特化したコントラクトを作成します。 // SPDX-License-Identifier: MIT pragma solidity ^0.8.20; import "@openzeppelin/contracts/token/ERC721/ERC721.sol"; import "@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol"; import "@openzeppelin/contracts/access/Ownable.sol"; contract CulturalHeritageNFT is ERC721, ERC721URIStorage, Ownable { uint256 private _nextTokenId; // 文化財の基本情報 struct CulturalItem { string name; // 文化財名 string description; // 説明 string institution; // 所蔵機関 string dateCreated; // 制作年代 uint256 mintedAt; // NFT発行日時 } // tokenId => CulturalItem mapping(uint256 => CulturalItem) public culturalItems; event CulturalItemMinted( uint256 indexed tokenId, address indexed owner, string name, string institution, uint256 timestamp ); constructor() ERC721("CulturalHeritageNFT", "CHNFT") Ownable(msg.sender) {} /// @notice 文化財NFTを発行する /// @param to 発行先アドレス /// @param uri IPFS上のメタデータURI /// @param name 文化財名 /// @param description 説明 /// @param institution 所蔵機関 /// @param dateCreated 制作年代 function mintCulturalItem( address to, string memory uri, string memory name, string memory description, string memory institution, string memory dateCreated ) public onlyOwner returns (uint256) { uint256 tokenId = _nextTokenId++; _safeMint(to, tokenId); _setTokenURI(tokenId, uri); culturalItems[tokenId] = CulturalItem({ name: name, description: description, institution: institution, dateCreated: dateCreated, mintedAt: block.timestamp }); emit CulturalItemMinted( tokenId, to, name, institution, block.timestamp ); return tokenId; } /// @notice 文化財情報を取得する function getCulturalItem(uint256 tokenId) public view returns (CulturalItem memory) { require(tokenId < _nextTokenId, "Token does not exist"); return culturalItems[tokenId]; } // 必須のオーバーライド function tokenURI(uint256 tokenId) public view override(ERC721, ERC721URIStorage) returns (string memory) { return super.tokenURI(tokenId); } function supportsInterface(bytes4 interfaceId) public view override(ERC721, ERC721URIStorage) returns (bool) { return super.supportsInterface(interfaceId); } } このコントラクトの特徴は、標準的なERC721に加えて CulturalItem 構造体を持つ点です。文化財名、説明、所蔵機関、制作年代といった文化財固有の情報をオンチェーンに記録します。 ...

来歴追跡の重要性 文化財管理において、「来歴」（provenance）の記録は極めて重要です。ある文化財がいつ制作され、誰が所有し、どのような修復が行われ、どこで展示されてきたか—これらの情報は文化財の真正性を証明し、その価値を裏付ける根拠となります。 従来、来歴情報は紙の書類やデータベースで管理されてきましたが、改ざんのリスクや機関間でのデータ共有の困難さといった問題がありました。本章では、ブロックチェーンのイベントログを活用して、改ざん不可能な来歴追跡システムを実装します。 履歴イベントの設計 Solidityのイベント（Event）機能を使用して、文化財に関する様々な出来事を記録します。イベントはブロックチェーン上のトランザクションログに永続的に記録され、後からフィルタリングして検索できます。 // SPDX-License-Identifier: MIT pragma solidity ^0.8.20; import "@openzeppelin/contracts/token/ERC721/ERC721.sol"; import "@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol"; import "@openzeppelin/contracts/access/Ownable.sol"; contract CulturalHeritageNFT is ERC721, ERC721URIStorage, Ownable { uint256 private _nextTokenId; // 履歴の種類を表す列挙型 enum HistoryType { Creation, // 登録 Restoration, // 修復 Exhibition, // 展示 Transfer, // 移管 Appraisal, // 鑑定 Documentation, // 記録更新 Other // その他 } // 履歴エントリの構造体 struct HistoryEntry { uint256 tokenId; HistoryType historyType; string description; string documentUri; // 関連ドキュメントのIPFS URI address recordedBy; uint256 timestamp; } // tokenId => 履歴エントリの配列 mapping(uint256 => HistoryEntry[]) public histories; // 履歴記録権限を持つアドレス mapping(address => bool) public authorizedRecorders; // イベント定義 event HistoryRecorded( uint256 indexed tokenId, HistoryType indexed historyType, string description, string documentUri, address indexed recordedBy, uint256 timestamp ); event RecorderAuthorized(address indexed recorder); event RecorderRevoked(address indexed recorder); modifier onlyAuthorized() { require( owner() == msg.sender || authorizedRecorders[msg.sender], "Not authorized to record history" ); _; } constructor() ERC721("CulturalHeritageNFT", "CHNFT") Ownable(msg.sender) {} /// @notice 履歴記録権限を付与する function authorizeRecorder(address recorder) external onlyOwner { authorizedRecorders[recorder] = true; emit RecorderAuthorized(recorder); } /// @notice 履歴記録権限を取り消す function revokeRecorder(address recorder) external onlyOwner { authorizedRecorders[recorder] = false; emit RecorderRevoked(recorder); } /// @notice 文化財の履歴を記録する function recordHistory( uint256 tokenId, HistoryType historyType, string memory description, string memory documentUri ) external onlyAuthorized { require(tokenId < _nextTokenId, "Token does not exist"); HistoryEntry memory entry = HistoryEntry({ tokenId: tokenId, historyType: historyType, description: description, documentUri: documentUri, recordedBy: msg.sender, timestamp: block.timestamp }); histories[tokenId].push(entry); emit HistoryRecorded( tokenId, historyType, description, documentUri, msg.sender, block.timestamp ); } /// @notice 特定トークンの履歴件数を取得する function getHistoryCount(uint256 tokenId) external view returns (uint256) { return histories[tokenId].length; } /// @notice 特定トークンの指定インデックスの履歴を取得する function getHistory(uint256 tokenId, uint256 index) external view returns (HistoryEntry memory) { require(index < histories[tokenId].length, "Index out of bounds"); return histories[tokenId][index]; } // --- 以下、前章のミント機能など（省略）--- function tokenURI(uint256 tokenId) public view override(ERC721, ERC721URIStorage) returns (string memory) { return super.tokenURI(tokenId); } function supportsInterface(bytes4 interfaceId) public view override(ERC721, ERC721URIStorage) returns (bool) { return super.supportsInterface(interfaceId); } } 履歴記録の権限管理 文化財の履歴は、信頼できる関係者のみが記録できるべきです。コントラクトでは authorizedRecorders マッピングを使い、コントラクトのオーナー（管理者）が特定のアドレスに記録権限を付与できる仕組みを採用しています。 ...

レンタル機能の必要性 文化財の管理において、「貸出」は日常的に発生する重要な業務です。博物館間での作品の貸借、特別展への出品、調査のための一時的な移管など、文化財は所有機関以外の場所で利用されることが頻繁にあります。 NFTを使ったデジタル文化財管理システムでは、この「貸出」をどのように表現するかが課題となります。本章では、最も単純なアプローチとして「所有権の転送」によるレンタルの実装を試みますが、この方法には重大な問題があることを確認します。 :::message alert 本章の実装は問題を含んでおり、実用には適しません。次章でERC-4907を使った適切な実装に置き換えます。あえて問題のあるアプローチを先に示すことで、ERC-4907の必要性を理解していただくことを目的としています。 ::: 所有権転送によるレンタルの実装 最初のアプローチでは、ERC721の transferFrom を使って所有権を一時的に移転し、レンタル期間終了後に返却（再転送）するという方法を考えました。 // SPDX-License-Identifier: MIT pragma solidity ^0.8.20; import "@openzeppelin/contracts/token/ERC721/ERC721.sol"; import "@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol"; import "@openzeppelin/contracts/access/Ownable.sol"; contract CulturalHeritageRentalV1 is ERC721, ERC721URIStorage, Ownable { struct RentalInfo { address originalOwner; // 元の所有者 address borrower; // 借用者 uint256 startTime; // 貸出開始時刻 uint256 endTime; // 貸出終了時刻 bool isActive; // 貸出中フラグ } mapping(uint256 => RentalInfo) public rentals; event RentalStarted( uint256 indexed tokenId, address indexed originalOwner, address indexed borrower, uint256 startTime, uint256 endTime ); event RentalEnded( uint256 indexed tokenId, address indexed returnedTo ); constructor() ERC721("CulturalHeritageRentalV1", "CHR1") Ownable(msg.sender) {} /// @notice NFTを貸し出す（所有権を転送） function startRental( uint256 tokenId, address borrower, uint256 duration ) external { require(ownerOf(tokenId) == msg.sender, "Not the owner"); require(!rentals[tokenId].isActive, "Already rented"); // 元の所有者を記録 rentals[tokenId] = RentalInfo({ originalOwner: msg.sender, borrower: borrower, startTime: block.timestamp, endTime: block.timestamp + duration, isActive: true }); // 所有権を借用者に転送 _transfer(msg.sender, borrower, tokenId); emit RentalStarted( tokenId, msg.sender, borrower, block.timestamp, block.timestamp + duration ); } /// @notice NFTを返却する（所有権を元に戻す） function endRental(uint256 tokenId) external { RentalInfo memory rental = rentals[tokenId]; require(rental.isActive, "Not currently rented"); require( msg.sender == rental.borrower || msg.sender == rental.originalOwner, "Not authorized" ); // 所有権を元の所有者に戻す _transfer(rental.borrower, rental.originalOwner, tokenId); rentals[tokenId].isActive = false; emit RentalEnded(tokenId, rental.originalOwner); } // 以下、必須オーバーライド function tokenURI(uint256 tokenId) public view override(ERC721, ERC721URIStorage) returns (string memory) { return super.tokenURI(tokenId); } function supportsInterface(bytes4 interfaceId) public view override(ERC721, ERC721URIStorage) returns (bool) { return super.supportsInterface(interfaceId); } } フロントエンドからの呼び出し import { ethers } from "ethers"; // レンタルの開始 async function startRental( tokenId: number, borrowerAddress: string, durationDays: number ) { const durationSeconds = durationDays * 24 * 60 * 60; const tx = await contract.startRental( tokenId, borrowerAddress, durationSeconds ); const receipt = await tx.wait(); console.log("レンタル開始:", receipt.hash); } // レンタルの終了（返却） async function endRental(tokenId: number) { const tx = await contract.endRental(tokenId); const receipt = await tx.wait(); console.log("返却完了:", receipt.hash); } // 使用例: 30日間のレンタル await startRental( 0, "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18", 30 ); 発見された問題点 このアプローチをテストしていく中で、以下の重大な問題が明らかになりました。 ...

ERC-4907とは 前章では、所有権の転送によるNFTレンタルが深刻な問題を抱えていることを確認しました。本章では、ERC-4907（Rental NFT）規格を使用してこの問題を根本的に解決します。 ERC-4907は、EIP-4907として2022年に標準化されたERC721の拡張規格です。この規格の核心は、所有者（owner）と利用者（user）を分離するという点にあります。 E E R R C o C o u 7 w - w s 2 n 4 n e 1 e 9 e r （ r 0 r 標 7 準 （ ） 拡 : 張 ） ト : ト 一 ー ー 時 ク ク 的 ン ン な の の 利 完 所 用 全 有 権 な 権 （ 所 （ 有 有 変 効 権 更 期 な 限 し 付 ） き ） 利用者は有効期限（expires）が設定され、期限を過ぎると自動的に利用権が消滅します。所有権は常に元の所有者に留まるため、前章で問題となった「借用者がNFTを転送してしまう」リスクがありません。 ...

フロントエンドとブロックチェーンの接続 これまでの章で、Solidityによるスマートコントラクトの開発を進めてきました。本章では、Next.jsを使ったフロントエンドアプリケーションからMetaMaskウォレットに接続し、ブラウザ上で文化財NFTの操作を行えるようにします。 ウォレット接続には、wagmi（React Hooks for Ethereum）と ethers.js v6 を使用します。wagmiは、Reactコンポーネントからウォレット接続やコントラクト呼び出しを簡潔に記述するためのライブラリです。 プロジェクトのセットアップ # Next.jsプロジェクトの作成 npx create-next-app@latest cultural-heritage-frontend --typescript --app cd cultural-heritage-frontend # 必要なパッケージのインストール npm install wagmi viem @tanstack/react-query npm install @rainbow-me/rainbowkit npm install ethers wagmiの設定 wagmiの設定ファイルを作成し、Sepoliaテストネットへの接続を構成します。 // src/config/wagmi.ts import { http, createConfig } from "wagmi"; import { sepolia, hardhat } from "wagmi/chains"; import { getDefaultConfig } from "@rainbow-me/rainbowkit"; export const config = getDefaultConfig({ appName: "Cultural Heritage NFT", projectId: process.env.NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID!, chains: [sepolia, hardhat], transports: { [sepolia.id]: http( `https://eth-sepolia.g.alchemy.com/v2/${process.env.NEXT_PUBLIC_ALCHEMY_API_KEY}` ), [hardhat.id]: http("http://127.0.0.1:8545"), }, }); プロバイダーの設定 アプリケーション全体をwagmiとRainbowKitのプロバイダーで囲みます。 // src/app/providers.tsx "use client"; import { WagmiProvider } from "wagmi"; import { RainbowKitProvider } from "@rainbow-me/rainbowkit"; import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; import { config } from "@/config/wagmi"; import "@rainbow-me/rainbowkit/styles.css"; const queryClient = new QueryClient(); export function Providers({ children }: { children: React.ReactNode }) { return ( <WagmiProvider config={config}> <QueryClientProvider client={queryClient}> <RainbowKitProvider> {children} </RainbowKitProvider> </QueryClientProvider> </WagmiProvider> ); } // src/app/layout.tsx import { Providers } from "./providers"; export default function RootLayout({ children, }: { children: React.ReactNode; }) { return ( <html lang="ja"> <body> <Providers>{children}</Providers> </body> </html> ); } ウォレット接続ボタン RainbowKitの ConnectButton を使って、ウォレット接続UIを実装します。 ...