Azure55562/pinion-os

🛠 Habilite chamadas de habilidades on-chain sem interrupções com micropagamentos x402 automatizados usando o SDK Pinion OS e a estrutura de servidor de habilidades.

O que é pinion-os?

O Azure55562/pinion-os é um skill de IA que permite que agentes de IA, como o Claude Code, executem chamadas de habilidades on-chain de forma transparente, automatizando micropagamentos via protocolo x402. Ele é útil para desenvolvedores que desejam integrar funcionalidades baseadas em blockchain em seus agentes, pagando apenas pelo uso real. A skill suporta o Pinion OS SDK e um framework de servidor de habilidades, facilitando a criação e o consumo de habilidades on-chain sem a necessidade de gerenciar manualmente transações ou saldos. Ao usar o SKILL.md, o agente configura automaticamente o ambiente, gerencia chaves privadas e interage com contratos inteligentes, tornando o processo seguro e eficiente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Azure55562/pinion-os

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que pinion-os faz?

🛠 Habilite chamadas de habilidades on-chain sem interrupções com micropagamentos x402 automatizados usando o SDK Pinion OS e a estrutura de servidor de habilidades.

Visão Geral

Este skill permite que agentes de IA integrem e executem habilidades on-chain com pagamentos automáticos via o protocolo x402. Com o Pinion OS SDK, você pode:

  • Publicar habilidades como ativos on-chain.
  • Consumir habilidades pagando micropagamentos automáticos.
  • Gerenciar chaves e saldos de forma segura.

Pré-requisitos

  • Node.js 18+
  • Uma chave privada de carteira Ethereum (não compartilhe)
  • Acesso à rede Polygon (Mumbai ou Mainnet)

Instalação

npm install @pinion-os/sdk

Uso

Configuração do Ambiente

Crie um arquivo .env com:

PINION_PRIVATE_KEY=0x...
PINION_RPC_URL=https://rpc-mumbai.maticvigil.com

Exemplo: Chamando uma Habilidade

import { PinionClient } from '@pinion-os/sdk';

const client = new PinionClient({
  privateKey: process.env.PINION_PRIVATE_KEY,
  rpcUrl: process.env.PINION_RPC_URL,
});

const result = await client.callSkill({
  skillId: '0x...',
  args: { prompt: 'Gere um poema sobre blockchain' },
});

console.log(result);

Como Funciona

  1. O agente gera uma requisição de chamada de habilidade.
  2. O Pinion OS SDK calcula o custo em microtransações.
  3. O pagamento é feito automaticamente via x402.
  4. A habilidade é executada on-chain.
  5. O resultado é retornado ao agente.

Suporte

  • Plataformas: Claude Code, Cursor, Codex
  • Redes: Polygon Mumbai (testnet), Polygon Mainnet
  • Versão do SDK: 1.0.0+

Segurança

  • Nunca compartilhe sua chave privada.
  • Use variáveis de ambiente para credenciais.
  • Teste em testnet antes de ir para mainnet.

Licença

MIT

Habilidades Relacionadas