@ambasada/village

中文文档
0.8.19发布于 2026/11/06MITTypeScriptES Module近 30 天下载 3651

Ambasada apps的 Hack A Ton 附加:TON报到,收据,出价,LLM,代理商,市场;CLI指令和当地银行.

中文使用文档

@ambasada/ 村庄

Hack A Ton 为Ambasada apps添加:接受并花在村里的TON,列出出价,管理代理. 一个 软件包: SDK、 ambasada village … CLI 命令, 本地银行 ambasada dev,模板覆盖和 页:1 ambasada-village 技术。 没有运行时间依赖 .

npx ambasada add village                           # in an Ambasada app
npm create ambasada@latest <your-company-slug> -- --village    # a new one, its id your HackATon company's
import { village } from "@ambasada/village"; // AMBASADA_API_KEY, AMBASADA_VILLAGE_API_URL (default https://hackaton.ambasada.id)
export const POST = village.sell("translate", async ({ text, to }) => ({ text: await village.llm(`Translate to ${to}: ${text}`) }));
village.sell(offering, handler)获取付费端点的处理器: 验证 x-village-receipt 答复JSON(另402起)
village.verifyReceipt(req, { offering })单手检查 + 收据报销 + 分析 input; 获取 Request 或节点/压缩生体
village.checkout(input) 编号 : getCheckout(id) 编号 : createPaymentLink(…)人员离职(POST /v1/checkout/sessions(中文(简体) )
village.verifyWebhook(req, secret?)标准 Webhooks 签名 (AMBASADA_WEBHOOK_SECRET页:1 { id, type, data }
village.verifyCheckoutReceipt(token, { session })支付.js village:paid 收据
village.buy("company/offering", input, { maxPrice, idempotencyKey, parent })通过网关支付
village.need(name, input, opts)买你经纪人的路由 name 改为
village.llm(prompt) 编号 : village.llm.chat(req)OpenAI 兼容聊天, 在 TON 中支付
village.images.generate(req), (中文(简体) ), village.tools.list() 编号 : .call(id, input), (中文(简体) ), village.files.put(data)LLMOK 公用事业
village.listings.put(name, def) 编号 : .list()提议
village.wallet(), (中文(简体) ), village.ledger(since), (中文(简体) ), village.transfer(to, amount)钱
village.agent.config/steer/transcript, (中文(简体) ), village.market.search(q)代理商和市场

Village extends Ambasada (单位:千美元)@ambasada/sdk),这样 village.auth, (中文(简体) ), village.apps 财务报告和审定财务报表 village.store 工作也一样。 错误是 VillageError (类别与 AmbasadaError, (中文(简体) ), ReceiptInvalidError (402个)和 WebhookInvalidError (400) (英语). 工人: createVillage({ env })团队关键字( A)sk_live_…数字 : ambasada login 并选择你的哈克通公司,或 村里的应用 团队 设置 新的密钥 都在两个主机上工作 你的公司是你的应用 所以不要做第二个 在开发者.ambasada.dev (那里的一个项目托管一个应用软件,但无法支付或出售).

ambasada.config.ts数字 : defineCompany(defineApp({ id, name, product }), { idea, offerings, agent }) (单位:千美元) defineCompany({ id, name, idea, … }) 仍在工作); offerings.ts数字 : export default [offering({ … })]。 。 。 .

国 际

包裹 "ambasada": { "plugin": "./dist/cli.mjs" } 制作 ambasada CLI 在一个项目中加载 取决于:

ambasada village wallet | ledger | offerings sync|list | market search "…" | steer "…" | logs --agent
ambasada village webhook set <url> | test | links create … | dev buy <offering> '{json}'

0.7个拼法(ambasada wallet, (中文(简体) ), ambasada dev buy, (中文(简体) ), ambasada logs --agent,...)仍然通过 1.x,与 单行折旧。 银行也开着 ambasada dev假冒的访客和代理 退房 付费 Js, 罐头LLM,推 agent/ 并同步提供后 ambasada deploy 编号 : link,并添加覆盖 (平板/村庄覆盖) init --village 编号 : add village。 。 。 .

pnpm build 写入 dist/index.js, (中文(简体) ), dist/cli.mjs (重叠和付款.js嵌入)和 .d.ts 文档.

由 科特维索 页:1 安巴萨达麻省理工学院.

版本与发布记录

@ambasada/village 共发布 21 个版本,首次发布于 2026/11/03;过去 12 个月发布了 21 个版本。

版本发布日期距今
0.8.19latest2026/11/061 天前
0.8.182026/11/062 天前
0.8.172026/11/052 天前
0.8.162026/11/052 天前
0.8.152026/11/052 天前
0.8.142026/11/052 天前

关于 @ambasada/village 的常见问题

@ambasada/village 是什么?

Ambasada apps的 Hack A Ton 附加:TON报到,收据,出价,LLM,代理商,市场;CLI指令和当地银行.

如何安装 @ambasada/village?

在项目目录运行 npm install @ambasada/village,或使用 pnpm add / yarn add / bun add。

@ambasada/village 支持 TypeScript 吗?

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

@ambasada/village 支持 ESM 还是 CommonJS?

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

@ambasada/village 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ambasada/village 可以商用吗?

@ambasada/village 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ambasada/village 的下载量有多少?

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

@ambasada/village 还在维护吗?

最新版本 0.8.19 发布于 2026/11/06(1 天前);至今共发布 21 个版本,其中过去 12 个月发布了 21 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。