📝 IPA 메타데이터 표준

​

속성 및 구조

• 🔍 Story Explorer - 이 필드는 Story Explorer에서 IP를 표시하는 데 도움이 됩니다
• 🕵️ 상업적 침해 확인 - 이 필드는 IP가 상업적인 경우 (즉, commercialUse = true 라이선스 조건이 첨부된 경우) 필요합니다. 우리는 이 필드들을 사용하여 IP에 대한 침해 확인을 실행할 것입니다.
  • 참조: 현재 제한사항.
• 🤖 AI 에이전트 - AI 에이전트와 관련된 메타데이터 표시에 사용됨

​

유형 정의

type IpCreator = {
  name: string;
  address: Address;
  contributionPercent: number; // add up to 100
  description?: string;
  image?: string;
  socialMedia?: IpCreatorSocial[];
  role?: string;
};

type IpCreatorSocial = {
  platform: string;
  url: string;
};

​

미디어 유형

​

콘텐츠 해싱

import { toHex, Hex } from "viem";

// get hash from a file
async function getFileHash(file: File): Promise<Hex> {
  const arrayBuffer = await file.arrayBuffer();
  const hashBuffer = await crypto.subtle.digest("SHA-256", arrayBuffer);
  return toHex(new Uint8Array(hashBuffer), { size: 32 });
}

// get hash from a url
async function getHashFromUrl(url: string): Promise<Hex> {
  const response = await axios.get(url, { responseType: "arraybuffer" });
  const buffer = Buffer.from(response.data);
  return "0x" + createHash("sha256").update(buffer).digest("hex");
}

​

사용 사례 예시

{
  "title": "Ippy",
  "description": "Official mascot of Story.",
  "createdAt": "1728401700",
  "image": "https://ipfs.io/ipfs/QmSamy4zqP91X42k6wS7kLJQVzuYJuW2EN94couPaq82A8",
  "imageHash": "0x21937ba9d821cb0306c7f1a1a2cc5a257509f228ea6abccc9af1a67dd754af6e",
  "mediaUrl": "https://ipfs.io/ipfs/QmSamy4zqP91X42k6wS7kLJQVzuYJuW2EN94couPaq82A8",
  "mediaHash": "0x21937ba9d821cb0306c7f1a1a2cc5a257509f228ea6abccc9af1a67dd754af6e",
  "mediaType": "image/png",
  "creators": [
    {
      "name": "Story Foundation",
      "address": "0x67ee74EE04A0E6d14Ca6C27428B27F3EFd5CD084",
      "description": "The World's IP Blockchain",
      "contributionPercent": 100,
      "socialMedia": [
        {
          "platform": "Twitter",
          "url": "https://twitter.com/storyprotocol"
        },
        {
          "platform": "Telegram",
          "url": "https://t.me/StoryAnnouncements"
        },
        {
          "platform": "Website",
          "url": "https://story.foundation"
        },
        {
          "platform": "Discord",
          "url": "https://discord.gg/storyprotocol"
        },
        {
          "platform": "YouTube",
          "url": "https://youtube.com/@storyFDN"
        }
      ]
    }
  ],
  "tags": ["Ippy", "Story", "Story Mascot", "Mascot", "Official"], // experimental field
  "ipType": "Character" // experimental field
}

​

선택적 속성

​

유형 정의

type IpRelationship = {
  parentIpId: Address;
  type: string; // see "Relationship Types" docs below
};

​

관계 유형

​

스토리 관계

1. APPEARS_IN - 캐릭터가 챕터에 등장합니다.
2. BELONGS_TO - 챕터가 책에 속합니다.
3. PART_OF - 책이 시리즈의 일부입니다.
4. CONTINUES_FROM - 챕터가 이전 챕터에서 이어집니다.
5. LEADS_TO - 사건이 결과로 이어집니다.
6. FORESHADOWS - 사건이 미래의 발전을 암시합니다.
7. CONFLICTS_WITH - 캐릭터가 다른 캐릭터와 갈등합니다.
8. RESULTS_IN - 결정이 중요한 변화를 초래합니다.
9. DEPENDS_ON - 서브플롯이 메인 플롯에 의존합니다.
10. SETS_UP - 프롤로그가 이야기를 설정합니다.
11. FOLLOWS_FROM - 챕터가 이전 챕터에 이어집니다.
12. REVEALS_THAT - 반전이 예상치 못한 일이 일어났음을 드러냅니다.
13. DEVELOPS_OVER - 캐릭터가 이야기 전반에 걸쳐 발전합니다.
14. INTRODUCES - 챕터는 새로운 캐릭터나 요소를 INTRODUCES합니다.
15. RESOLVES_IN - 갈등은 특정 결과로 RESOLVES_IN됩니다.
16. CONNECTS_TO - 주제는 주요 내러티브와 CONNECTS_TO됩니다.
17. RELATES_TO - 서브플롯은 중심 주제와 RELATES_TO됩니다.
18. TRANSITIONS_FROM - 장면은 한 배경에서 다른 배경으로 TRANSITIONS_FROM합니다.
19. INTERACTED_WITH - 캐릭터는 다른 캐릭터와 INTERACTED_WITH합니다.
20. LEADS_INTO - 사건은 절정으로 LEADS_INTO됩니다.
    PARALLEL - story 병렬로 또는 같은 시간대에 일어나는 일

​

AI 관계

1. TRAINED_ON - 모델은 데이터셋에 TRAINED_ON됩니다.
2. FINETUNED_FROM - 모델은 기본 모델에서 FINETUNED_FROM됩니다.
3. GENERATED_FROM - 이미지는 미세 조정된 모델에서 GENERATED_FROM됩니다.
4. REQUIRES_DATA - 모델은 훈련을 위해 데이터를 REQUIRES_DATA합니다.
5. BASED_ON - 리믹스는 특정 워크플로우에 BASED_ON됩니다.
6. INFLUENCES - 샘플 데이터는 모델 출력을 INFLUENCES합니다.
7. CREATES - 파이프라인은 미세 조정된 모델을 CREATES합니다.
8. UTILIZES - 워크플로우는 기본 모델을 UTILIZES합니다.
9. DERIVED_FROM - 미세 조정된 모델은 기본 모델에서 DERIVED_FROM됩니다.
10. PRODUCES - 모델은 생성된 이미지를 PRODUCES합니다.
11. MODIFIES - 리믹스는 기본 워크플로우를 MODIFIES합니다.
12. REFERENCES - AI 생성 이미지는 원본 데이터를 REFERENCES합니다.
13. OPTIMIZED_BY - 모델은 특정 알고리즘에 의해 OPTIMIZED_BY됩니다.
14. INHERITS - 미세 조정된 모델은 기본 모델의 특징을 INHERITS합니다.
15. APPLIES_TO - 미세 조정 과정은 모델에 APPLIES_TO됩니다.
16. COMBINES - 리믹스는 여러 데이터셋의 요소를 COMBINES합니다.
17. GENERATES_VARIANTS - 모델은 이미지의 변형을 GENERATES_VARIANTS합니다.
18. EXPANDS_ON - 미세 조정 과정은 기본 기능을 EXPANDS_ON합니다.
19. CONFIGURES - 워크플로우는 모델의 매개변수를 CONFIGURES합니다.
20. ADAPTS_TO - 미세 조정된 모델은 새로운 데이터에 ADAPTS_TO합니다.