API 키
API 키가 있으면 AI 에이전트나 프로그램이 나를 대신해 토큰 출시를 준비하고 진행 상황을 읽을 수 있습니다. 키로는 서명하거나, 자산을 쓰거나, 토큰을 옮길 수 없습니다. 토큰은 지갑만 만들 수 있습니다. 키는 앱의 API 페이지, launch.gama.win/api에서 관리합니다.
에이전트로 처음 출시한다면 AI 에이전트로 토큰 출시하기부터 읽으세요.
키 만들기
키를 관리할 지갑을 연결합니다. 토큰을 출시하는 지갑과 달라도 됩니다.

- 키 이름: 키에 붙이는 이름이며 최대 64자입니다. 예: "출시 에이전트".
- 만료일 (선택 사항): 최대 1년 뒤까지의 날짜입니다. 키는 그날이 끝날 때(UTC 기준) 작동을 멈춥니다. 비워 두면 폐기할 때까지 작동합니다.
- 권한: 키로 할 수 있는 일입니다. 기본으로 세 가지 모두 켜져 있습니다.
- API 키 만들기: 지갑 서명을 요청하고 키를 한 번만 보여 줍니다.
- 키와 출시 내역 불러오기: 서명하면 내 키와 출시 내역을 보여 줍니다.
이 페이지의 모든 동작은 지갑에 그 동작의 이름이 적힌 메시지 서명을 요청합니다. 트랜잭션이 아닙니다. 가스비가 들지 않고 어떤 지출도 승인하지 않습니다.
API 키 만들기를 누르면 새 API 키에 "지금 키를 저장하세요. 다시 표시되지 않습니다."라는 안내와 함께 키가 한 번만 표시됩니다. 키 복사를 누르고 에이전트의 비밀 설정에 저장한 뒤 저장했어요를 누르세요.
WARNING
키를 가진 사람은 누구나 내 사용 한도를 쓸 수 있습니다. 비밀 관리 도구나 비공개 설정 파일에 보관하세요. 대화, 프롬프트, 웹 주소에 붙여 넣지 마세요.
키는 키를 만든 GAMA 컨트랙트 릴리스에서 작동합니다. 웹사이트와 서비스가 업데이트되어도 그대로 쓸 수 있습니다. 새 컨트랙트 릴리스가 나오면 API 페이지에서 새 키를 만드세요. 이전 릴리스의 키와 출시 내역은 새 릴리스로 옮겨지지 않습니다.
권한
- 내 출시 내역 읽기: 내 키로 준비한 출시와 그 상태를 봅니다.
- 출시 준비: 출시를 시작하고, 지갑이 서명할 수 있게 준비하고, 트랜잭션을 보고합니다.
- 이미지 업로드: 토큰 이미지를 올립니다.
출시를 대신 준비하는 에이전트에는 앞의 두 가지가 필요합니다. 이미지 업로드는 토큰 이미지를 올릴 때만 필요합니다. 지출하거나 서명하는 권한은 없습니다.
한도
페이지의 지갑당 한도에 현재 값이 표시됩니다.
| 한도 | 값 |
|---|---|
| 활성 키 | 1 |
| 진행 중인 출시 | 1 |
| 출시 준비 | 분당 6회 |
| 이미지 업로드 | 시간당 10회 |
출시는 확인됨 또는 실패가 될 때까지 진행 중으로 계산됩니다. 서비스 전체 한도도 적용되므로 요청이 몰릴 때는 에이전트가 기다려야 할 수 있습니다.
키와 출시 내역 불러오기를 누르면 같은 카드에 그 시점에 내 지갑이 허용량별로 사용한 양과 초기화 시각이 표시됩니다. 새 수치를 보려면 새로고침을 누르세요.
내 키와 출시 내역 보기
키와 출시 내역 불러오기를 누르고 서명합니다. 내 API 키에 키의 이름과 식별자, 권한, 생성 일시, 마지막 사용, 만료가 표시됩니다. 더 이상 작동하지 않는 키에는 폐기됨 또는 만료됨이 표시됩니다. 키 자체는 다시 표시되지 않습니다.
내 출시 내역에는 내 키로 준비한 출시가 나열됩니다.
- 작성 중: 시작했지만 아직 준비되지 않았습니다.
- 준비 완료: 지갑이 검토할 출시 계획이 있습니다. 서명하려면 자금이나 승인이 더 필요할 수 있습니다.
- 대기 중: 트랜잭션이 보고됐거나, 결과가 아직 확인되지 않았습니다.
- 확인됨: 출시 트랜잭션이 확인됐고 토큰이 만들어졌습니다.
- 실패: 토큰을 만들지 않고 종료됐습니다. 예를 들어 전송하지 않은 출시입니다.
확인됐거나 실패한 출시는 마지막 업데이트로부터 30일 뒤 목록에서 사라집니다. 끝나지 않은 출시는 끝날 때까지 남습니다. 끝내거나 종료하는 방법은 끝나지 않은 출시 이어가기를 참고하세요.
키 교체하기
키 교체를 누르고 서명합니다. 이전 키는 작동을 멈추고, 이름, 권한, 만료일이 같은 새 키가 한 번만 표시됩니다. 키를 잃어버렸거나 다른 사람이 봤을 수 있을 때 사용하고, 새 키를 에이전트에 전달하세요.
키를 교체해도 끝나지 않은 출시는 종료되지 않습니다. 새 키로 이어서 진행합니다.
키 폐기하기
폐기를 누르고 서명합니다. 키는 작동을 멈춥니다. 되돌릴 수 없습니다.
키를 폐기해도 지갑이 이미 서명한 트랜잭션은 취소되지 않습니다.
지갑 하나에 활성 키는 하나이므로, 이름, 만료일, 권한이 다른 새 키를 만들려면 먼저 기존 키를 폐기해야 합니다. 그러지 않으면 페이지에 "이 지갑에는 이미 활성 키가 있습니다. 먼저 그 키를 교체하거나 폐기하세요."가 표시됩니다.
