bankr-dev-api-workflow

This skill should be used when building the async job workflow, implementing polling loops, handling job status transitions, processing rich data, managing conversation threads, or understanding the full submit-poll-complete lifecycle of the Bankr Agent API.

Ir para a instalação

Repositório: BankrBot/claude-plugins
Última atividade na origem: 24 de março de 2026 às 01:00
Idioma detectado do SKILL.md: inglês
Estrelas: 80
Forks: 30

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/BankrBot/claude-plugins --skill bankr-dev-api-workflow

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

bankr-dev-safety-access-control

This skill should be used when building secure Bankr integrations, implementing API key management, configuring access controls, setting up dedicated agent wallets, or handling rate limits and security best practices in Bankr API projects.

2026-03-24

bankr-dev-sign-submit-api

This skill should be used when building apps that need to sign messages, sign typed data (EIP-712), sign transactions, or submit raw transactions via the Bankr API. Covers the synchronous /agent/sign and /agent/submit endpoints with TypeScript patterns.

2026-03-24

bankr-agent-agent-profiles

This skill should be used when the user asks about "agent profile", "create profile", "update profile", "project profile", "bankr.bot/agents", "profile page", "project updates", or any agent profile management operation.

2026-03-24

Ver todas deste repositório

const status = await fetch(`${API_URL}/agent/job/${jobId}`, {
  headers: { "x-api-key": API_KEY },
});

const cancel = await fetch(`${API_URL}/agent/job/${jobId}/cancel`, {
  method: "POST",
  headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
});

Status	Description	Action
`pending`	Job queued, not started	Keep polling
`processing`	Job running	Keep polling, show statusUpdates
`completed`	Finished successfully	Read response and richData
`failed`	Encountered error	Check error field
`cancelled`	Was cancelled	No further action

async function waitForCompletion(
  jobId: string,
  onProgress?: (message: string) => void
): Promise<JobStatusResponse> {
  const POLL_INTERVAL = 2000; // 2 seconds
  const MAX_POLLS = 150;      // 5 minutes max
  let lastUpdateCount = 0;

  for (let i = 0; i < MAX_POLLS; i++) {
    const status = await getJobStatus(jobId);

    // Report new status updates
    if (onProgress && status.statusUpdates) {
      for (let j = lastUpdateCount; j < status.statusUpdates.length; j++) {
        onProgress(status.statusUpdates[j].message);
      }
      lastUpdateCount = status.statusUpdates.length;
    }

    // Terminal states
    if (["completed", "failed", "cancelled"].includes(status.status)) {
      return status;
    }

    await new Promise((r) => setTimeout(r, POLL_INTERVAL));
  }

  throw new Error("Job timed out");
}

// Start a conversation
const first = await submitPrompt("What is the price of ETH?");
const threadId = first.threadId;

// Continue the conversation (agent remembers context)
const second = await submitPrompt("And what about BTC?", threadId);

// Each response includes the same threadId

type RichData = {
  type?: string;          // "social-card", "chart", etc.
  [key: string]: unknown;
};

Status	Error	Resolution
400	Invalid request / Prompt too long	Check input (max 10,000 chars)
401	Authentication required	Check API key
403	Agent API not enabled	Enable at bankr.bot/api
404	Job not found	Check jobId is correct
429	Rate limit exceeded	Wait for `resetAt` timestamp

// Handle rate limits
if (response.status === 429) {
  const error = await response.json();
  const waitMs = error.resetAt - Date.now();
  console.log(`Rate limited. Resets in ${Math.ceil(waitMs / 60000)} minutes`);
}

import { submitPrompt, waitForCompletion } from "./bankr-client";

async function main() {
  // Submit
  const { jobId } = await submitPrompt("Swap 0.1 ETH for USDC on Base");
  console.log(`Job: ${jobId}`);

  // Poll with progress
  const result = await waitForCompletion(jobId, (msg) => {
    console.log(`Progress: ${msg}`);
  });

  // Handle result
  if (result.status === "completed") {
    console.log(result.response);
    for (const tx of result.transactions || []) {
      console.log(`Transaction: ${tx.type}`);
    }
  } else if (result.status === "failed") {
    console.error(`Failed: ${result.error}`);
  }
}

name	Bankr Dev - API Workflow
description	This skill should be used when building the async job workflow, implementing polling loops, handling job status transitions, processing rich data, managing conversation threads, or understanding the full submit-poll-complete lifecycle of the Bankr Agent API.
version	1.0.0

name	Bankr Dev - API Workflow
description	This skill should be used when building the async job workflow, implementing polling loops, handling job status transitions, processing rich data, managing conversation threads, or understanding the full submit-poll-complete lifecycle of the Bankr Agent API.
version	1.0.0

bankr-dev-api-workflow

Opções de instalação

Revise os arquivos de origem

API Workflow

Core Pattern: Submit-Poll-Complete

Endpoints

POST /agent/prompt

API Workflow

Core Pattern: Submit-Poll-Complete

Endpoints

POST /agent/prompt

GET /agent/job/{jobId}

POST /agent/job/{jobId}/cancel

Job Status States

Response Fields

Standard (all states)

Completed

Processing

Failed

Cancelled

Polling Implementation

Polling Best Practices

Conversation Threads

Rich Data

Error Handling

Complete Example

Related Skills

bankr-dev-api-workflow

Informações da origem

Opções de instalação

Revise os arquivos de origem

Mais deste repositório

Mais deste repositório

API Workflow

Core Pattern: Submit-Poll-Complete

Endpoints

POST /agent/prompt

API Workflow

Core Pattern: Submit-Poll-Complete

Endpoints

POST /agent/prompt

GET /agent/job/{jobId}

POST /agent/job/{jobId}/cancel

Job Status States

Response Fields

Standard (all states)

Completed

Processing

Failed

Cancelled

Polling Implementation

Polling Best Practices

Conversation Threads

Rich Data

Error Handling

Complete Example

Related Skills