explaingit

lily-protocol/lily-sdk

Analysis updated 2026-05-18

14TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A typed Node.js SDK for giving AI agents their own crypto wallets, payments, and identity on the Stellar network.

Mindmap

mindmap
  root((Lily SDK))
    What it does
      Typed Node.js client
      Agent wallets
      Payments and identity
    Tech stack
      TypeScript
      Node.js
      Stellar network
    Use cases
      Provision agent wallets
      Quote and send payments
      Resolve agent identity
    Audience
      Backend developers
      AI agent platforms

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give an autonomous AI agent its own wallet on the Stellar network.

USE CASE 2

Request a payment quote and send funds between agent wallets.

USE CASE 3

Resolve an agent's verified identity before authorizing a transaction.

USE CASE 4

Check system health of the Lily backend before running automated payments.

What is it built with?

TypeScriptNode.jsStellarVitest

How does it compare?

lily-protocol/lily-sdk0xbebis/hyperpayalfredxw/nova
Stars141414
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardmoderate
Complexity2/55/53/5
Audiencedeveloperdeveloperwriter

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Needs an API key and base URL for the Lily backend before wallet or payment calls will work.

MIT license: use, copy, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

In plain English

Lily SDK is a TypeScript library for connecting Node.js applications to the Lily Protocol platform, which provides financial infrastructure for autonomous AI agents. In plain terms, if you are building software where AI agents need their own wallets, need to send and receive payments, or need a verified identity, this SDK gives your code typed access to those capabilities through a clean JavaScript interface. The SDK is organized into focused modules covering agents, wallets, payments, identity, and system health. For example, you can provision a wallet for an agent on the Stellar network, request a payment quote between two wallets using USDC, or resolve an agent's identity, all with TypeScript types so your editor catches mistakes before you run the code. The underlying HTTP transport handles authentication headers, timeouts, and retry logic, so you do not need to write that plumbing yourself. The package installs from npm as @lily-protocol/sdk and ships both ESM and CommonJS builds, so it works in modern module based projects and in older CommonJS setups. The SDK connects to Stellar, a public blockchain network commonly used for fast, low cost payments. The README notes this is production oriented foundation work, with some methods still using conservative request models while the backend evolves. You would use this SDK if you are building backend services that automate financial transactions on behalf of AI agents, such as autonomous purchasing, small recurring payment collection, or agent to agent fund transfers. The project also ships with a Vitest test suite, ESLint and Prettier configuration, and GitHub Actions continuous integration, so contributors get consistent formatting and automated checks on every change they submit.

Copy-paste prompts

Prompt 1
Show me how to install @lily-protocol/sdk and provision a test wallet for an agent.
Prompt 2
Explain how sdk.payments.quote works and what fields it needs.
Prompt 3
Help me write a script that resolves an agent's identity before sending a payment.
Prompt 4
Walk me through the SDK's error hierarchy so I can handle failed payments correctly.

Frequently asked questions

What is lily-sdk?

A typed Node.js SDK for giving AI agents their own crypto wallets, payments, and identity on the Stellar network.

What language is lily-sdk written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Stellar.

What license does lily-sdk use?

MIT license: use, copy, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is lily-sdk to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is lily-sdk for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.