# @altananetwork/sdk 中文文档

规范地址：https://npmcn.com/package/%40altananetwork/sdk/

版本：0\.9\.0
npm 元数据更新时间：2026-09-02T09:52:15.347Z
中文译文更新时间：2026-11-07T00:16:10.720Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40altananetwork/sdk
原文对照：https://npmcn.com/package/%40altananetwork/sdk/?lang=original
项目主页：https://docs.altana.network/
源码仓库：https://github.com/altananetwork/altana-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：440 kB，111 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-07-07T22:45:23.024Z
- 最新版本发布：2026-09-02T09:52:15.182Z
- 近 30 天下载量：2119（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

TypeScript SDK用于创建带有链上会话键授权的非拘禁智能代理钱包.

## 安装

```sh
npm install @altananetwork/sdk
```

也可以使用：`pnpm add @altananetwork/sdk`、`yarn add @altananetwork/sdk`、`bun add @altananetwork/sdk`

## README

# @altana网络/sdk

TypeScript SDK用于创建带有链上会话键授权的非拘禁智能代理钱包.

```bash
npm install @altananetwork/sdk viem
```

## 快开始

为您想要的链条创建客户端 。 通过一个L1或几个:相同 钱包地址在您配置的每个链条上工作.

```ts
import { createClient, ETHEREUM, BNB } from "@altananetwork/sdk";

// Both L1s, or just one, your choice.
const client = createClient({ chains: [ETHEREUM, BNB] });
```

### 密码钱包( 浏览器)

```ts
const wallet = await client.createPasskeyWallet({ name: "My Agent Wallet" });
```

### 私钥钱包(服务器/代理)

```ts
import { signerFromPrivateKey } from "@altananetwork/sdk";

const signer = signerFromPrivateKey(process.env.PRIVATE_KEY);
const wallet = await client.createWallet({ signer });
```

### 授权会话并执行

操作需要选择 `chainId` (客户端第一个链的默认值):

```ts
const session = await client.grantSession({
  wallet,
  signer,
  permissions: {
    calls: [{ to: "0x…" }],
    spend: [{ limit: 1_000_000n, period: "day" }], // 1 USDC/day
  },
  expiry: Math.floor(Date.now() / 1000) + 60 * 60, // 1 hour
});

await client.execute({
  session,
  chainId: 56, // BNB Smart Chain; omit to use the default chain
  calls: [{ to: "0x…", value: 0n, data: "0x…" }],
});
```

### 支付x402的API

会话键可以通过x402标准(Permit2或EIP-3009)支付HTTP资源 铁轨),从智能钱包上定居在链上. 规定一次,然后透明地支付:

```ts
import { PERMIT2_ADDRESS } from "@altananetwork/sdk";

// One-time, as admin (permit2 rail):
await client.approveTokenForPermit2({ wallet, signer, token: "0xUSDC…" });
await client.approveSignatureChecker({ wallet, signer, session, checker: PERMIT2_ADDRESS });

// The agent pays + fetches (server-side):
const res = await client.fetchWithX402({ session, url: "https://api.example.com/paid" });
```

该账户的ERC-1271签字授权付款。 见 [链外签名](https://docs.altana.network/concepts/off-chain-signatures)。 。 。 .

### 雇用另一名代理人(ERC-8183)

代理人可以互相雇佣和支付工作报酬. `hireErc8183Agent` 运行整个 买方流动(创建、登记、预算、核准、基金)作为原子继电器 ,并在工作获得连锁资助后返回.

```ts
import { hireErc8183Agent, getErc8183Job, BNB } from "@altananetwork/sdk";

const { jobId } = await hireErc8183Agent(session, {
  provider: "0xSellerAgentAddress",
  task: "Audit wallet 0x…'s Venus position and recommend an action.",
  budget: 100_000_000_000_000_000n, // 0.1 $U (18 decimals)
}, { network: BNB });

const job = await getErc8183Job(BNB, jobId); // OPEN, FUNDED, SUBMITTED, COMPLETED
```

管理路径是 `hireErc8183Agent(wallet, signer, params, opts)`。使用 会话路径指的是一个有范围化的密钥,其链上开支限制上限为 一个自主的代理人永远可以代管. `settleErc8183Job` 核准或争议 交货,以及 `buildClaimRefundCall` 如果一无所获,则收回预算.

全文 : [ERC-8183 代理工作](https://docs.altana.network/sdk/erc8183)。 。 。 .

### 给特工一个身份(ERC-8004)

买家通过ERC-8004身份登记处找到卖家. 一个特工可以薄荷 并保持自己的参与,有一个会议 关键范围仅针对这两个呼叫—— `erc8004RegisterPermissions` 赠款 `register` 财务报告和审定财务报表 `setAgentURI` 编辑 登记簿和没有其他内容,因此一个已损坏的会话不能转让 识别或批准一个超过其撤销寿命的操作员.

```ts
import {
  erc8004RegisterPermissions,
  registerErc8004Agent,
  setErc8004AgentUri,
  encodeErc8004AgentUri,
  withErc8004Registration,
  BNB,
} from "@altananetwork/sdk";

// Grant: permissions: { calls: erc8004RegisterPermissions(56), spend: [...] }

const record = {
  type: "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  name: "Vault Sentinel",
  description: "Watches Venus positions.",
  services: [{ name: "A2A", endpoint: "https://sentinel.example/.well-known/agent-card.json" }],
  registrations: [], // the id does not exist until the mint assigns it
} as const;

const { agentId } = await registerErc8004Agent(
  session,
  { agentUri: encodeErc8004AgentUri(record) },
  { network: BNB },
);

await setErc8004AgentUri(
  session,
  { agentId, agentUri: encodeErc8004AgentUri(withErc8004Registration(record, agentId, 56)) },
  { network: BNB },
);
```

注册是两相的,因为记录嵌入了薄荷所分配的id. `getErc8004Agent(BNB, agentId)` 记录所有者 `agentId`,因为登记处没有反向查询.

全文 : [ERC-8004 代理身份](https://docs.altana.network/sdk/erc8004)。 。 。 .

## 文档

完整的文件、概念指南和SDK参考: [**网页**](https://docs.altana.network/)。 。 。 .

资料来源: [github.com/altana网络/altana-sdk](https://github.com/altananetwork/altana-sdk)。 。 。 .

## 许可证

阿帕奇 - 2.0

## 常见问题

### @altananetwork/sdk 是什么？

TypeScript SDK用于创建带有链上会话键授权的非拘禁智能代理钱包\.

### 如何安装 @altananetwork/sdk？

在项目目录运行 npm install @altananetwork/sdk，或使用 pnpm add / yarn add / bun add。

### @altananetwork/sdk 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @altananetwork/sdk 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @altananetwork/sdk 可以商用吗？

@altananetwork/sdk 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @altananetwork/sdk 的下载量有多少？

根据 npm 官方下载统计，@altananetwork/sdk 在 2026/10/06 – 2026/11/04 这 30 天内被下载 2,119 次，日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @altananetwork/sdk 还在维护吗？

最新版本 0\.9\.0 发布于 2026/09/02（2 个月前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/07/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。