Pinata V3 API グループ機能の実装ガイド

Pinata の Files API v3 でグループ機能を使用する際のはまりポイントと解決策をまとめます。 背景 Pinata でアップロードしたファイルをグループで管理し、特定のグループに属するファイルのみを取得したいケースがあります。例えば、NFT登録フォームで使用する入力画像を「input」グループに格納し、そのグループからのみ画像を選択できるようにする場合などです。 はまりポイント 1. レガシーAPI と V3 API のファイル管理は分離されている 問題 : レガシーAPI(pinFileToIPFS)でアップロードしたファイルは、V3 API(/v3/files)では取得できません。逆も同様です。 レ V ガ 3 シ ー A A P P I I ( p v i 3 n / L f i i s l t e ) s ) → レ ガ → シ ー で V ア 3 ッ で プ ア ロ ッ ー プ ド ロ し ー た ド フ し ァ た イ フ ル ァ の イ み ル 表 の 示 み 表 示 解決策 : どちらかのAPIに統一する。V3 APIに移行する場合は、新規アップロードからV3を使用し、既存ファイルは手動でグループに追加するか、マイグレーションを検討。 ...

2025年12月28日 · 11 分 · Nakamura

デジタル文化財管理システム(試行版)のNFT対応

お知らせ: 2025-06-14 開発の経過は以下にまとめています。 https://zenn.dev/nakamura196/books/41693d2d017082 概要 以下の記事をはじめとして、ブロックチェーンを用いたデジタル文化財管理システムの試作をしています。 今回、アップロードしたデータがNFTとして認識されるように改修しました。 勉強過程のため、不完全な点があるかと思いますが、参考になりましたら幸いです。 使い方ページ ファイルのアップロード方法はこれまでと同様です。アップロード後に表示される一覧ページにおいて、詳細ページへのリンクを追加しました。 リンクをクリックすると、以下のような詳細画面に遷移します。 実装方法 ※ この章は、AIが執筆しました。 1. コントラクトのNFT対応 既存のデジタル文化財管理コントラクトを、ERC721規格に準拠したNFTコントラクトに改修しました。 主な変更点: 1. OpenZeppelinライブラリの追加 i i m m p p o o r r t t " " @ @ o o p p e e n n z z e e p p p p e e l l i i n n / / c c o o n n t t r r a a c c t t s s - - u u p p g g r r a a d d e e a a b b l l e e / / t t o o k k e e n n / / E E R R C C 7 7 2 2 1 1 / / E e R x C t 7 e 2 n 1 s U i p o g n r s a / d E e R a C b 7 l 2 e 1 . U s R o I l S " t ; o r a g e U p g r a d e a b l e . s o l " ; 2. コントラクトの継承構造を変更 ...

2025年6月12日 · 9 分 · Nakamura

OpenSeaに画像を登録してみる

概要 OpenSeaに画像を登録してみたので、その備忘録です。 作成したアイテムのページは以下です。 https://opensea.io/assets/ethereum/0x495f947276749ce646f68ac8c248420045cb7b5e/10640296615676167047199551942164304992363478966543389627838835760480269631489 OpenSeaへのアップロード OpenSeaへの画像のアップロードは簡単に行うことができました。 一方、それまでのMetaMaskやOpenSeaのアカウント作成などに少し時間がかかりました。この手順についてはたくさんの記事がありましたので、そちらを参考にしてください。 bitFlyerからMetaMaskへの送金 bitFlyerで保有して0.005ETHをMetaMaskへ送金しました。この送金手数料に0.005ETH($7.72, 990.48円)かかりました。(高い…笑) メタデータの凍結 編集画面の「凍結」メニューから、メタデータの凍結を試みました。この凍結にも以下のガス代がかかりました。 0.00185631883313057 Ether ($2.87) 凍結が完了したところ、以下のように、Metadataが「Frozen」と表示されます。 そのリンクをクリックしてみると、以下のjsonファイルがダウンロードされます。 { } " " " " i n d e m a e x a m s t g e c e e " r r _ : i n u p a r " t l l k i _ " u o u : n n r s " l " h : " i u : p j " f o 『 " s " 捃 h : , 拾 t / 帖 t / 』 p b 九 s a 五 : f ( / y 東 / b 京 u e 大 v i 学 - c 総 v 2 合 4 7 図 . x 書 n y 館 e q 所 t z 蔵 l 2 ) i z を f k 改 y 4 変 . b " a g , p q p l / y # c ? 7 m t a p n m i v f c e l s 6 t i = t h f t m t v p k s y : w / 2 / j i d p n f v s 2 . b i 7 o 5 / 7 i t p 3 f z s 7 / i Q f m u W b M y W / H i A m w a v g P e L " i , n D 8 a D Z f 9 H X f y 1 4 u 3 S N d Z R T z b q g M Q J 9 5 Q 3 b " さらにimage_urlの値から、URLにアクセス、またはIPFSのデスクトップアプリでbafybeic27xyqz2zk4bgqlyc7tpmvcl6itfmvkyw2jdnv2b757t3z7ifubyをBrowseすると、画像を閲覧することができました。 ...

2023年1月16日 · 2 分 · Nakamura