WaveClamp
워크플로우

게임 아이템 계약서의 ERC1155 _mint: 계획부터 테스트까지

03
게임 아이템 세트

게임 아이템 계약서에 발행 기능 추가하기

서로 다른 토큰 ID를 가진 검, 물약, 열쇠를 발행하는 하나의 계약서가 필요하고, 누가 새 토큰을 생성할 수 있는지 확인하고 싶다고 가정해 보세요. 에이전트가 Solidity 코드를 작성하고 로컬 체인이나 테스트 네트워크에서 컴파일 및 테스트 명령을 실행한 뒤, 각 단계를 실제 결과와 함께 카드 형태로 보여줍니다. 이 가이드는 토큰 발행 함수를 따라가는데, 이 함수를 호출할 수 있는 사람이 토큰의 총 공급량을 결정하기 때문입니다. 배포된 계약서는 수정할 수 없으므로, 여기서는 가치가 없는 테스트 네트워크의 코인을 사용하는 로컬 체인에서 모든 작업을 진행합니다. 초보자는 네 단계를 순서대로 따라갈 수 있고, 경험이 많은 독자는 하단의 실습 가이드로 바로 넘어갈 수 있습니다. 이 네 단계는 티켓 세트에도 동일하게 적용됩니다. 각 티켓 유형마다 고유한 ID가 부여되며, 발행 함수가 각 유형의 발행 수량을 결정합니다.

01

프로젝트 폴더 열기

WaveClamp를 시작하고, .sol 파일과 테스트 파일이 포함된 폴더를 채팅의 작업 폴더로 선택하세요. 그리고 Ask first를 선택해 모든 변경 사항을 diff로 받아 수락하거나 거부할 수 있게 하세요. 파일 도구는 해당 폴더 내에서 작동하므로 프로젝트는 한 곳에 보관하세요. 처음 실행 시 연습용만 원한다면 임시 폴더를 만들어 사용하세요.

02

계약서 설명하기

세 가지 아이템 유형과, 오너 계정만 호출할 수 있는 발행 함수, 그리고 일괄 전송 기능이 있는 게임 아이템 계약서를 요청하세요. 그리고 에이전트가 write_file을 사용해 파일을 생성하도록 하세요. 파일명은 계약서 이름과 동일하게 지정해 나중에 다른 단계에서 참조할 수 있게 하세요. 첫 요청은 간단하게 하세요. 첫 번째 diff를 수락한 후에야 두 번째 요청으로 일괄 전송 기능을 추가할 수 있기 때문입니다.

03

컴파일 및 테스트 실행하기

에이전트에게 Shell을 통해 컴파일 명령과 테스트 명령을 실행하도록 지시하세요. 그런 다음 확장된 카드에서 종료 코드와 실패한 테스트의 이름을 확인하세요. 성공 여부는 요약문이 아닌 실제 종료 코드로 판단합니다. 컴파일 명령이 실패하면 카드에 오류 텍스트가 표시되며, 에이전트가 이를 읽고 새로운 diff로 수정안을 제안할 수 있습니다.

04

결과 읽기

확장된 카드를 열고 diff와 명령어 출력을 읽은 뒤, 올바른 부분은 수락하고 나머지는 거부하세요. 여전히 테스트가 실패하는 부분에 대해 수정을 요청하세요. 테스트가 모두 통과할 때까지 이 과정을 반복한 후, 발행 함수를 다시 한 번 읽어보세요. 수락하는 diff는 작게 유지하세요. 그래야 나중에 실패가 발생했을 때 그 원인이 한 가지 변경 사항 때문인지, 열 가지 때문인지 명확하게 파악할 수 있습니다.

시작할 수 있는 최소한의 인터페이스

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

interface IMultiTokenMinimal {
    event TransferSingle(address indexed operator,
        address indexed from, address indexed to,
        uint256 id, uint256 value);

    function balanceOf(address account, uint256 id)
        external view returns (uint256);

    function uri(uint256 id)
        external view returns (string memory);
}

이 읽기 전용 인터페이스는 멀티토큰 표준의 TransferSingle 이벤트와 balanceOf, uri 함수를 선언합니다. 상태 저장, 발행 로직, 키가 없으므로 실제 로직을 추가하기 전에 읽기 쉬운 작은 파일입니다. 먼저 이 파일로 컴파일 명령을 실행하세요. 먼저 컴파일한 뒤, 에이전트에게 발행 함수부터 시작해 검토된 diff를 하나씩 확장하도록 요청하세요. 파일명은 예제 레이블과 일치하므로 나중에 에이전트에게 파일을 열라고 요청할 수 있습니다.

실습 가이드: 발행, 비교, 일괄 전송 및 토큰 설명

발행 함수 추가하기

계약서를 열고 에이전트에게 ERC1155 _mint 헬퍼를 오너 계정만 호출할 수 있는 public 함수로 감싸도록 요청하세요. 에이전트는 read_file을 사용해 현재 코드를 확인하고 edit_file을 사용해 함수를 삽입하며, 변경 사항을 diff로 보여줍니다. 일반적인 오픈소스 구현체는 _mint와 _mintBatch라는 이름의 내부 헬퍼를 노출하며, 내부 헬퍼 자체에는 접근 권한 확인 기능이 없습니다. 따라서 래퍼 함수가 중요한 것입니다. 동일한 방법으로 ERC20 토큰을 단계별로 생성할 수 있지만, 게임 아이템 세트에는 ID가 필요하므로 멀티토큰 레이아웃에서 시작하세요. Shell이 컴파일 명령과 테스트 명령을 실행하고, 각 카드에는 실제 종료 코드가 표시됩니다. 테스트를 확인한 후에만 diff를 수락하세요.

ERC-721 예시와 비교하기

프로젝트에서 ERC721 계약서 예시를 열거나, 에이전트에게 write_file을 통해 하나를 작성해 아이템 세트 옆에 배치하도록 요청하세요. 에이전트는 grep을 사용해 두 파일의 함수 목록을 나열하고 read_file을 사용해 소유권 저장 방식을 비교합니다: 고유 토큰 파일에는 토큰당 하나의 오너가 있고, 멀티토큰 파일에는 계정과 ID당 잔고가 있습니다. 소울바운드 NFT를 사용한 탈중앙화 프로필을 위한 표준은 전송할 수 없는 토큰이 필요하므로, 이는 플레이어가 서로 교환하는 아이템과는 다른 디자인입니다. 에이전트에게 차이점을 짧은 표로 정리해 달라고 요청하세요. 채팅에서 비교 내용을 읽고 어떤 표준이 자신의 디자인에 적합한지 결정한 후, 코드 변경을 요청하세요.

일괄 전송 추가하기

플레이어는 종종 여러 아이템 유형을 한 번에 이동하므로, 에이전트에게 계약서에 safeBatchTransferFrom과 balanceOfBatch를 추가하도록 요청하세요. 에이전트는 edit_file로 변경을 적용하고 glob으로 테스트 파일을 찾은 후, 각 편집마다 Shell을 통해 테스트 명령을 실행합니다. 일괄 함수는 하나의 트랜잭션으로 여러 토큰 ID를 이동하므로, 하나의 테스트로 여러 잔고를 확인할 수 있습니다. ERC4337 가스 없는 온보딩 이해는 별도의 주제이므로 첫 계약서에서 제외하고 별도로 테스트하세요. Ask first에서 diff를 읽고 테스트를 다시 실행한 후, 변경 사항을 수락하기 전에 출력에서 TransferBatch 이벤트를 확인하세요.

수신자 및 메타데이터 확인하기

토큰을 받는 계약서는 onERC1155Received과 onERC1155BatchReceived를 구현하고 토큰을 수락해야 합니다. 그렇지 않으면 안전한 전송이 거부됩니다. 에이전트에게 grep으로 두 이름을 검색하고 read_file로 수신 계약서를 열어 어떤 것이 누락되었는지 나열하도록 요청하세요. 그런 다음 uri(id) 값에 {id}가 포함되도록 edit_file을 사용하라고 요청하세요. 클라이언트는 이를 토큰 ID의 소문자 16진수로 대체하며, 64자리로 패딩됩니다. 각 ID마다 write_file을 사용해 JSON 파일을 하나씩 생성하세요. 컴파일 명령과 테스트 명령을 실행하고, 두 종료 코드를 읽은 후 최종 diff를 검토한 다음 수락하세요.

Windows용 WaveClamp

첫 번째 멀티토큰 계약서 시작하기

WaveClamp 다운로드 ↗