Skip to main content

meridian-finance-give-langchain

LangChain toolkit for Meridian Give, in Python. An agent finds a verified charity and donates its own USDC on Arc. No API key, no RPC, no contract address to configure.

pip install meridian-finance-give-langchain langchain-openai langgraph
import os
from meridian_finance_give_langchain import GiveToolkit
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

toolkit = GiveToolkit(private_key=os.environ["AGENT_PRIVATE_KEY"])

agent = create_react_agent(
    model=ChatOpenAI(model="gpt-5"),
    tools=toolkit.get_tools(),
)

Without a key the toolkit is read only.

Tools

Tool What it does
give_list_charities Charities accepting USDC on Arc, filtered by query, category, country, verified
give_get_charity One charity, by escrow address or name
give_get_receipt The receipt of a donation, read from the chain
give_get_spend_policy The agent's own caps and kill switch, and whether a gift fits
give_protocol_stats Totals across Give: donated, released, charities, donors
give_donate Gives the agent's own USDC and returns the receipt

How a donation works

Give writes a USDC permit for exactly that charity and that amount, the agent signs it locally with eth-account (the key never leaves the process), and Give relays the signed gift through GiveRouter and pays the gas. GiveRouter checks the escrow, the Give reference, the agent's ERC-8004 identity and its spend policy in the same transaction as the transfer.

Docs: https://give.themeridian.finance/docs#agents

License

MIT

Metadata

Release files for meridian-finance-give-langchain 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for meridian-finance-give-langchain 0.1.0
File Size Uploaded Provenance Actions
meridian_finance_give_langchain-0.1.0.tar.gz 6.4 kB Without provenance Details for meridian_finance_give_langchain-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for meridian-finance-give-langchain 0.1.0
File Interpreter ABI Platform Actions
meridian_finance_give_langchain-0.1.0-py3-none-any.whl Python 3 none any Details for meridian_finance_give_langchain-0.1.0-py3-none-any.whl

Total release size: 14.6 kB

Release files / meridian_finance_give_langchain-0.1.0.tar.gz

Download URL meridian_finance_give_langchain-0.1.0.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
1cb0ffa94ad73a8e683064da7848c30b413a9f0e38fed8a05e6d309eb38abab1
BLAKE2b-256 checksum
How to use checksums
d2154bc0152ea1cd271be1342cc87ec43609e8652e441e303a9a27efa0d3bad6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.0

Release files / meridian_finance_give_langchain-0.1.0-py3-none-any.whl

Download URL meridian_finance_give_langchain-0.1.0-py3-none-any.whl
Size 8.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b3c4c6dd6ee198511da9d3a9766d01c2afbaae23788fdf81e49f49743be34f5b
BLAKE2b-256 checksum
How to use checksums
b019cc01cb6d6ddc3bc0ffaea0797c171d69ddb3924ed8530db4900cb7ff2dfa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.0

Security for meridian-finance-give-langchain 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page