2-3 ホスト向けガイド

ホストは、SDGsの達成を目指してプロジェクトを提案・実行する主体です。個人や企業など、誰でもホストになることができ、持続可能な社会の実現に向けて具体的な取り組みを行います。

1. １．プロジェクト登録

   プロジェクトは、SDGs（持続可能な開発目標）の17の目標の中からテーマを選び、その達成を目指して取り組む活動です。法人・個人を問わず、誰でもホストとして自由にプロジェクトを立ち上げ、登録できます。

   ※各種イベントの開催や経済活動等による環境への影響をオフセットする目的で、それらのイベントをプロジェクトとして登録することも可能です。

   以下では、プロジェクト（SDGs活動）を本プログラムに登録する手順をご案内します。

   1. トップページのホストメニューから「プロジェクト登録」ボタンを押し、新規プロジェクト登録フォームに遷移します。
   2. フォームが表示されたら、以下の内容に従って各項目を入力します。
   1. 基本情報
   • プロジェクト名: 任意のプロジェクト名称を入力してください。
   • シンボル: プロジェクトを識別するためのユニークなコード。半角英字（大文字）4桁で設定してください。
   • SDGs目標: プロジェクトのSDGs目標を選択してください。プロジェクトの活動目的に即したSDGs目標である必要があります。
   • ターゲット: プロジェクト活動における主なターゲット、または関連するターゲットを選択してください。
   • プロジェクト概要: プロジェクトの目的と活動内容の要約を記載してください。
   • プロジェクト詳細: プロジェクトの具体的な計画、活動内容、対象者、期待する効果など、詳細な活動情報を記載します。
   2. 特典情報
   • 特典のタイプ: プロジェクトで提供する特典のタイプを「固定」または「変動」から選択します。特典を設定しない場合は「特典なし」を選択してください。

   プロジェクト特典には、「固定」と「変動」の二つのカテゴリーがあります。

   「固定特典」は、特定のコンサートチケットや期間限定のサービス券など、目的と内容が明確でプロジェクトの進捗や状況に左右されない特典の場合に選択します。

   一方、プロジェクトの進展に応じて特典の内容を柔軟に変更したい場合は、「変動特典」を選択します。これには、プロジェクトの成功に伴う特典の拡充や、不測の事態による特典の廃止が含まれます。

   ※固定特典の利用例:（一回限りの使い切り特典や、継続的な会員資格を付与する特典など））

   • 会員証（メンバーズ会員カード機能等）
   • 予約券
   • コンサートやイベント等のチケット

   ※変動特典の利用例:（主に将来にわたるプロジェクトトークンの価値向上に取り組みたい場合など）

   • 変動制の割引券・クーポン
   • プロジェクトの進捗や業績に応じて特典内容を拡充または縮小する可能性がある場合
   • 季節や期間、その他の条件によって特典内容を変更したい場合
   • 特典名: 特典を識別する名称を入力してください。
   • 必要PT数: 特典のミントに必要なエレメント数を設定します。エレメントをミントすると、同数のプロジェクトトークンが発行され、サポーターに付与されます。
   • 発行上限: 特典を紐づけるプロジェクトトークンの最大発行数を設定することで、当該特典の提供数を制限することができます。上限を設けない場合は空欄としてください。
   重要
   特典を設定した場合、サポーターはミント時に必ず特典を選択する必要があります。
   
   必要PT数が 2以上の場合、発行されたプロジェクトトークンは不可逆的にグループ化され、グループトークンとして扱われます。
   
   特典が未設定のプロジェクトでは、1エレメントごとにクラシックトークン※が発行されます。
   
   クラシックトークンの保有数に応じて特典や優待を提供する場合は、「プロジェクト詳細」に具体的な提供条件を明記してください。
   
   「必要PT数」以外の提供条件（例：特定のトークンID、ミント期間など）を設ける場合は、当該条件を「特典内容」または「プロジェクト詳細」に必ず明記してください。

   ※クラシックトークンは、特典情報を持たないベーシックなプロジェクトトークンです。特典情報を持たないため、必要PT数や発行上限は設定できず、シングルトークンとして扱われます。

   • 特典内容: 特典の内容を詳しく説明します。「必要PT数」以外の提供条件を設定する場合は、その詳細も必ず明記してください。
   • 提供方法: 特典の提供方法と手順を記載します。

   特典の提供方法については、内容に応じて受渡しや利用方法を明記してください。

   例えば、来店型の特典として物品やサービスを提供する場合は、マイコレクションページから表示できる トークンのQRコード※や対象のトークンリスト画面を来店時にスタッフに提示する方法などを記載します。

   また、チケットなどの入場券の場合は、ゲートで提示したり、専用のスキャナーにかざしたりすることが一般的です。

   一方、非来店型の場合は、トークンIDとアクセスコード（パスワード）を入力してオンラインで 特典を利用できるなど、実際に特典を受けとる方法を具体的に明記すると良いでしょう。

   各種プロジェクトの内容や特典の特性に応じて、対応可能な提供方法を設定してください。

   ※QRコードにはプロジェクトトークンのデータが含まれています。 近日リリース予定の専用アプリでは、ホスト向けに特典の真正確認や利用データの管理機能が無料で提供される予定です。 加えて、APIでも同様の機能が提供される予定で、ホストが独自のアプリケーションに本機能を統合することが可能になります。

   3. ミント制限
   • PT発行可能総数: PT発行可能総数に上限を設ける場合は、その最大数を設定してください。
     この設定は、プロジェクト全体のPT発行数を制限したい場合に使用します。発行数が上限に達すると、特典ごとの発行上限に関係なく、新規ミントができなくなります。
     なお、この設定は登録後も変更可能で、プロジェクトの進捗に応じて上限を引き上げたり、撤廃することができます。
   • 有効期間: 対象プロジェクトでミントの受付期間を設定したい場合に使用します。この設定は登録後に変更できません。
     例えば、期間限定プロジェクトでは、開始日と終了日を設定することで、ミントできる期間を事前に指定できます。
     また、開始日だけを設定すれば、プロジェクトの開始予約が可能です。終了日のみを設定して、ミント期限を設けることもできます。
   4. ロゴ情報
   • プロジェクト・ロゴ: プロジェクトを象徴するロゴ画像をアップロードします。この画像は発行されるPTのロゴとして使用されます。
   • アイキャッチ画像: プロジェクトの雰囲気を伝える画像を設定します。この画像はプロジェクト詳細ページの概要欄に表示されます。
   • バナー画像: プロジェクトを宣伝するためのバナー画像を設定します。
   5. ホスト情報
   • プロジェクトURL: プロジェクトの公式サイトやホストの詳細情報が確認できるURLを設定してください。これにより、ユーザーは詳細ページからプロジェクトの公式情報にアクセスできます。
   • 外部リンク: プロジェクトに関連するSNSリンク等を最大3つまで設定できます。
   3. 入力が完了したら、「確認ページへ進む」ボタンを押してください。
   4. 確認ページで入力内容を確認し、必要に応じて「修正」ボタンで入力内容を修正します。
   5. 内容に問題がなければ「登録」ボタンを押して登録処理を完了させてください。
   6. 「プロジェクトが登録されました」と表示されると、プロジェクトの登録が完了です。登録されたプロジェクトは本サービスサイトの「プロジェクトホーム」に即日公開されます。
2. ２．プロジェクト管理（編集・休止・ランク）

   登録完了後のプロジェクトは、「マイプロジェクト」ページから管理できます。このページでは、プロジェクトの確認、編集、休止、再開などの操作が可能です。以下に主要な機能と使用方法を説明します。

   1. プロジェクトの編集
      1. アクセス方法： プロジェクトホームのメニューバーからマイプロジェクトを選択します。
      2. 操作手順：
         1. マイプロジェクトページにアクセスすると、登録済みのプロジェクト一覧が表示されます。
         2. 編集したいプロジェクトのカードにある「編集」ボタンをクリックします。
         3. プロジェクト編集ページへ遷移後、既存の登録情報が入力されたフォームが表示されます。
         4. 編集を希望する項目の内容を更新します。編集しない項目は変更不要です。
         5. 全項目の編集が完了したら、ページ下部にある「プロジェクト更新」ボタンをクリックします。
         6. 確認メッセージが表示されたら、「OK」を選択して変更を確定します。

      更新後、詳細ページが表示され、「プロジェクトが更新されました」とのメッセージが表示されれば、更新は成功です。エラーが発生した場合は、エラーメッセージに従って、必要な修正を行ってください。

   2. プロジェクトの休止・再開

      本機能は、やむを得ない理由によりミントの受付を停止せざるを得ない状況になった場合にミントの受付を手動で休止および再開するための機能です。休止および再開の際は、サポーターが変更の理由と状況を適時に把握できるよう、公式サイトやSNSを通じて適切に情報を提供することが求められます。

      1. 休止の設定：
         1. 「マイプロジェクト」ページから、休止したいプロジェクトのトグルスイッチ（稼働中）を操作すると、プロジェクトは非アクティブ状態（休止中）に切り替わります。
         2. トグルスイッチを「非アクティブ」に切り替えると、プロジェクトは休止中と表示され、新規ミントの受付が停止されます。
      2. 再開の設定：
         1. 再開したいプロジェクトのトグルスイッチ（休止中）を操作します。
         2. トグルスイッチを「アクティブ」に切り替えると、プロジェクトが再び稼働中と表示され、新規のミント受付が再開されます。
   
   3. プロジェクトランク:

      プロジェクトランクは、プロジェクトトークン（PT）の発行数に基づいて設定・公開されます。ランクが上がると、プロジェクトのミント報酬やロイヤリティ（二次流通報酬率）が優遇されます。

      ランク	PT発行数の条件
      ダイアモンド	1,000,000以上
      プラチナ	100,000以上、1,000,000未満
      ゴールド	10,000以上、100,000未満
      シルバー	1,000以上、10,000未満
      ブロンズ	100以上、1,000未満
      ウッド	100未満

3. ３．プロジェクト報酬

   プロジェクト報酬は、プロジェクトの推進と持続的発展を支えるため、サポーターの活動やプロジェクトトークンの取引に応じてホストに支払われる報酬です。プロジェクト報酬は、「ミント報酬」と「ロイヤリティ」の2つに分類されます。

   1. 報酬の確認方法
      1. アクセス方法： プロジェクトホームのメニューバーからマイプロジェクトを選択します。
      2. マイプロジェクトページの「プロジェクト報酬」タブをクリックします。
      3. 当該ページでは、ミントおよびロイヤリティのそれぞれの報酬を確認でき、対象年月やシンボルで絞り込みが可能です。
      4. ページ下部の報酬明細テーブルにて、ミントとロイヤリティのタブ分けされた表示により、各ミントおよびPTの取引ごとの詳細を確認できます。
   2. ミント報酬
      1. ミント報酬は、サポーターがプロジェクトをミントした際にホストへ支払われるインセンティブで、ミント時のプロジェクトランクに基づいて算定されます。
      2. 報酬の算定と支払い：
         1. サポーターがミントを実行すると、プログラムがミント実行時点のプロジェクトランクを確認します。
         2. 該当ランクの報酬額（法定通貨「円」）が、暗号通貨（POL）に時価換算され、報酬として算定されます。
         3. 算定されたミント報酬はホストがプロジェクト登録時に設定したウォレットアドレスに送金されます。
      3. 報酬額：

         各プロジェクトランクに対応するミント報酬額（1PTあたりの金額）は以下の通りです。

         ランク	報酬額 (単位: 円)
         ダイアモンド	380
         プラチナ	375
         ゴールド	365
         シルバー	350
         ブロンズ	330
         ウッド	300

   3. ロイヤリティ
      1. ロイヤリティは、プロジェクトトークンがマーケットプレイスで取引された際に、取引価格とプロジェクトランクに応じたロイヤリティ率を基に算定されます。
      2. ロイヤリティの算定と支払い：
         1. プロジェクトトークンが取引された際、取引価格に基づき取引成立時点のプロジェクトランクに応じたロイヤリティ率が適用されます。
         2. 適用されたロイヤリティ率に基づきロイヤリティ額が算定され、購入者が選択した暗号通貨（POLまたはWETH）で支払われます。
         3. 算定されたロイヤリティはホストがプロジェクト登録時に設定したウォレットアドレスに送金されます。
      3. ロイヤリティ率：

         各プロジェクトランクに対応するロイヤリティ率は、次の通りです。

         ランク	ロイヤリティ率 (%)
         ダイアモンド	8.25%
         プラチナ	8.0%
         ゴールド	7.75%
         シルバー	7.5%
         ブロンズ	7.25%
         ウッド	7.0%

4. ４．API

   本APIは、ホストが特典提供時にサポーターから提示されたプロジェクトトークン（NFT）のQRコードを通じて、対象NFTの所有権および関連情報をブロックチェーンにリアルタイムで照会する機能を提供します。 これにより、ホストは既存のPOS（会計）システムや独自アプリケーションから、安全かつ迅速にNFT所有権の検証および特典内容等の確認を行い、特典提供時の認証業務を効率化できます。
   以下では、APIキーの取得方法や具体的な呼び出し手順について解説します。

   1. APIキーの取得
      1. まず、マイプロジェクトページにアクセスします。
      2. プロジェクト一覧が表示されたら、APIキーを確認したいプロジェクトカードの「詳細」ボタンをクリックします。
      3. 管理者向けのプロジェクト詳細ページが表示され、その中にAPIキーが表示されます。
         
         例） APIキー: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6a7b8c9d0e1f
      4. APIキーの右側に表示されているコピーアイコンをクリックすると、クリップボードにコピーされます。コピーしたAPIキーは、外部に漏洩しないよう大切に管理してください。

      ※ APIキーはプロジェクトごとに発行されており、複数のプロジェクトを運営する場合、それぞれ異なるAPIキーが割り当てられます。

      APIキー表示例（管理者向け詳細ページ内）▼

      
   2. APIのエンドポイント

      本サービスのAPIは、以下のエンドポイントを通じてNFTの真正確認を行うことができます。

      Base URL

      エンドポイント詳細

      エンドポイント	HTTPメソッド	説明
      /verify_nft	POST	QRコード情報を用いてNFTの真正性を確認します。

      リクエストヘッダー

      キー	値	説明
      X-API-KEY	プロジェクト専用のAPIキー	APIキーの認証に使用されます。 必須項目
      Content-Type	application/json	リクエストデータ形式。 必須項目

      リクエストボディ

      パラメータ名	型	必須	説明
      encoded_data	string (Base64)	必須	QRコード情報をBase64エンコードした文字列
      action	string	任意	使用カウントを操作したい場合に指定可能なパラメータ。 use: usage_count を +1 cancel: usage_count を -1 (0未満にはならない) 省略: カウント操作なし

      レスポンスボディ

      キー	型	説明
      success	boolean	API呼び出しが成功したかどうかを示します。
      isAuthentic	boolean	NFTが真正であるかを示します。
      message	string	処理結果やエラーメッセージ
      token_id	integer	NFTのトークンID
      wallet_address	string	NFT所有者のウォレットアドレス
      project_code	string	プロジェクトコード
      project_name	string	プロジェクト名
      benefit_bundle_code	string	特典バンドルコード
      benefit_name	string	特典名
      usage_count	integer	使用カウント。 action="use" の場合は +1、"cancel" の場合は -1（下限0）した値が返ります。 未指定の場合は更新されません。

      レスポンス例（成功時 - シングルトークン）

      
                                  {
                                      "success": true,
                                      "isAuthentic": true,
                                      "message": "Token verified successfully",
                                      "wallet_address": "0xABC...123",
                                      "token_id": 101,
                                      "project_name": "プロジェクト名",
                                      "benefit_name": "特典名",
                                      "usage_count": 3
                                  }

      レスポンス例（成功時 - グループトークン）

      
                                  {
                                      "success": true,
                                      "isAuthentic": true,
                                      "message": "Group tokens verified successfully",
                                      "wallet_address": "0xABC...123",
                                      "benefit_bundle_code": "XXXX-XXXX",
                                      "token_ids": [101, 102],
                                      "benefit_name": "特典名",
                                      "usage_count": 5,
                                      "project_name": "プロジェクト名"
                                  }

      レスポンス例（否認時 - 所有権確認失敗）

      
                                  {
                                      "success": false,
                                      "isAuthentic": false,
                                      "message": "On-chain balance check failed"
                                  }
                                  

      以上のパラメータ仕様を理解し、適切にリクエストを送信してください。

   3. APIの呼び出し方

      APIを利用する際には、取得したAPIキーをリクエストヘッダーに含めて送信します。以下はNFTの真正確認を行うためのリクエスト例です。

      Pythonサンプルコード

      
                                  import requests
                          
                                  BASE_URL = "https://sustina-plus.jp/api/v1/external"
                                  API_KEY = "コピーしたAPIキーを貼り付けてください"
                                  
                                  headers = {
                                      "X-API-KEY": API_KEY,
                                      "Content-Type": "application/json"
                                  }
                                  
                                  # Base64エンコードしたQRコード情報等を "encoded_data" に設定
                                  payload = {
                                      "encoded_data": ""
                                  }
                                  
                                  endpoint = f"{BASE_URL}/verify_nft"
                                  
                                  response = requests.post(endpoint, headers=headers, json=payload)
                                  
                                  if response.status_code == 200:
                                      data = response.json()
                                      print("NFT真正確認結果:", data)
                                  else:
                                      print("エラー発生:", response.status_code, response.text)
                                  

      JavaScript（Fetch API）サンプルコード

      
                                  const BASE_URL = "https://sustina-plus.jp/api/v1/external";
                                  const API_KEY = "コピーしたAPIキーを貼り付けてください";
                                  
                                  // Base64エンコードしたQRコード情報等を "encoded_data" に設定
                                  const payload = {
                                  encoded_data: ""
                                  };
                                  
                                  fetch(`${BASE_URL}/verify_nft`, {
                                  method: "POST",
                                  headers: {
                                      "X-API-KEY": API_KEY,
                                      "Content-Type": "application/json"
                                  },
                                  body: JSON.stringify(payload)
                                  })
                                  .then(response => {
                                      if (!response.ok) {
                                      throw new Error(`APIエラー: ${response.status}`);
                                      }
                                      return response.json();
                                  })
                                  .then(data => {
                                      console.log("NFT真正確認結果:", data);
                                  })
                                  .catch(err => {
                                      console.error("エラーが発生しました:", err);
                                  });
                                  

      上記のPythonコードでは、X-API-KEY ヘッダーにAPIキーを設定し、POSTメソッドで/verify_nftにリクエストを送信します。

      レスポンスのHTTPステータスコードが200であれば成功としてデータを表示し、それ以外の場合はエラーメッセージを表示します。

      JavaScriptサンプルコードでも同様に、Fetch APIを用いてリクエストを送信し、レスポンスが成功かどうかを判定しています。

      encoded_data には、QRコードのデータをBase64エンコードした文字列を設定してください。

   4. APIキー管理の注意点
      • APIキーは機密情報です。ソースコードの公開リポジトリや第三者が閲覧可能な場所に記述しないでください。
      • 万が一APIキーが漏洩したり、不正利用が疑われる場合は速やかにキーを変更し、サポートへ連絡してください。
      • システムで複数人がAPIキーを共有する場合は、各プロジェクトの運用ルールを明確にし、アクセス権限管理を厳密に行うことを推奨します。
   5. トラブルシューティング

      APIが正常に動作しない場合は、以下の点を確認してください。

      • APIキーが正しいものか（誤って他のプロジェクトのキーを使用していないか）
      • Base URLやエンドポイントのURLに誤りがないか
      • HTTPメソッドがPOSTになっているか
      • encoded_dataに必要な情報が正しく含まれているか
      • QRコードが有効期限内（生成から５分以内）であるか（有効期限を過ぎた場合はエラーが発生します）
      • APIキーが無効または削除されていないか

      レスポンス例（エラー時）

      
                                  {
                                      "success": false,
                                      "message": "Invalid API key"
                                  }
                              
                                  {
                                      "success": false,
                                      "message": "No 'encoded_data' provided"
                                  }
                              
                                  {
                                      "success": false,
                                      "message": "Invalid QR data structure"
                                  }
                              
                                  {
                                      "success": false,
                                      "isAuthentic": false,
                                      "message": "QR code expired (over 5 minutes)"
                                  }
                                  

      上記のエラー例では、以下の原因が考えられます：

      • APIキーが無効、削除されている、または誤っている
      • リクエストボディにencoded_dataが含まれていない
      • QRコードデータ構造が不正（フォーマットエラーなど）
      • QRコードが発行されてから5分以上が経過している

      上記以外のエラーが発生した場合や原因が特定できない場合は、サポートまでご連絡ください。