에이전트 알림
에이전트는 내 출시, 그리고 내가 고른 지갑과 토큰에서 일어나는 일을 일어나는 즉시 따라갈 수 있습니다. 계속 실행되는 프로그램이 필요합니다. 닫아 버린 대화는 아무것도 받을 수 없습니다.
에이전트가 따라갈 수 있는 것
- 내 출시. 내 키로 준비한 출시의 모든 변화, 토큰이 GAMA에 나타나는 순간, 네트워크가 그 블록을 확정됐다고 알리는 순간입니다. 키를 관리하는 지갑만 받습니다.
- 내가 고른 지갑. 그 지갑의 크리에이터 지급과 수령, 보유자 보상 지급과 수령입니다. 고르지 않으면 키를 관리하는 지갑을 따라갑니다.
- 내가 고른 토큰 최대 25개. 출시, 졸업, 보상 지급과 수령입니다.
지급, 수령, 출시, 졸업은 체인에 공개되어 있으므로 어떤 지갑이나 토큰이든 따라갈 수 있습니다.
반영됨과 확정됨
모든 알림은 어떻게 관측됐는지를 알려 줍니다.
- 서비스: 새 준비처럼 서비스가 직접 기록한 내 출시의 변화입니다. 체인에서 관측된 것이 아닙니다.
- 반영됨: GAMA가 블록에서 확인했습니다. 최근 블록은 아직 바뀔 수 있습니다.
- 확정됨: 네트워크가 그 블록을 확정됐다고 알렸습니다. 이 알림이 따로 오는 것은 내 출시뿐입니다.
지급, 수령, 졸업은 반영됨으로 한 번만 도착합니다. 알림 묶음마다 가장 최근에 확정된 블록도 함께 표시되므로, 돈이 도착했는지에 따라 달라지는 일이라면 에이전트가 지급이 담긴 블록이 그 블록보다 뒤가 아닌지 확인하게 하세요.
WARNING
알림은 정보입니다. 서명하거나 무언가를 전송하라는 지시가 아니며, 토큰의 이름이나 설명도 에이전트에 대한 지시가 아닙니다.
에이전트에 필요한 것
- 내 출시 내역 읽기 권한이 있는 API 키. API 키를 참고하세요.
- 내 쪽에서 계속 실행되는 프로그램. GAMA의 명령줄 도구는 연결을 유지하고 다시 시작한 뒤에도 멈춘 지점을 기억합니다. SDK는 프로그램이 실행되는 동안에만 기억하므로, SDK로 만든 프로그램은 다시 시작해도 이어 가려면 그 지점을 직접 저장해야 합니다.
- 말을 걸 때만 동작하는 에이전트도 요청할 때마다 최신 알림을 읽을 수 있습니다.
GAMA는 내 서버를 호출하지 않습니다. 웹훅은 없습니다.
알림이 다시 시작될 때
GAMA는 최대 24시간 분량의 알림을 보관하며, 체인이 매우 바쁠 때는 더 적게 보관합니다. 에이전트가 그보다 오래 떠나 있었거나 체인에서 최근 블록이 교체됐다면 서비스가 그 사실을 알려 줍니다. 에이전트는 새 시작 지점을 받고, 내 출시와 지갑의 현재 상태를 다시 읽은 뒤, 거기서부터 이어 갑니다.
공백은 "아무 일도 없었다"로 보고되지 않습니다. 재연결 후 같은 알림이 두 번 도착할 수 있으며, 에이전트는 식별자로 이를 구분합니다.
한도
지갑 하나에 실시간 연결은 한 번에 하나이며, 연결은 2분마다 갱신됩니다. SDK와 명령줄 도구가 이를 알아서 처리합니다. 사용할 수 있는 실시간 연결이 없을 때도 알림을 한 페이지씩 읽는 방식은 계속 동작합니다.
