@lit-protocol/vincent-ability-erc20-approval 0.0.7-mma

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+## 1.0.2 (2025-07-08)
+
+### 🩹 Fixes
+
+- - Fixed `fail` results being returned as `success` in some cases ([867a2f85](https://github.com/LIT-Protocol/Vincent/commit/867a2f85))
+
+### 🧱 Updated Dependencies
+
+- Updated ability-sdk to 1.0.2
+- Updated app-sdk to 1.0.2
+
+### ❤️ Thank You
+
+- Daryl Collins

package/CONTRIBUTING.md

@@ -0,0 +1,89 @@
+# Contributing to Vincent Ability ERC20 Approval
+
+This document provides guidelines for contributing to the Vincent Ability ERC20 Approval project.
+
+## Overview
+
+The Vincent Ability ERC20 Approval is an ability to send ERC20 approve/allowance transactions from a Vincent app on behalf of the delegator. It's part of the Vincent Abilities ecosystem and is built using the Vincent Ability SDK.
+
+## Setup
+
+1. Follow the global setup instructions in the repository root [CONTRIBUTING.md](../../../CONTRIBUTING.md).
+2. Install dependencies:
+   ```bash
+   pnpm install
+   ```
+
+## Development Workflow
+
+### Testing
+
+Run tests:
+
+```bash
+nx test ability-erc20-approval
+```
+
+### Building the Lit Action
+
+Build the tool:
+
+```bash
+nx action:build ability-erc20-approval
+```
+
+### Deploying the Lit Action to IPFS
+
+Building will be done automatically. Deploy the tool:
+
+```bash
+nx action:deploy ability-erc20-approval
+```
+
+## Project Structure
+
+- `src/`: Source code
+  - `index.ts`: Main entry point
+
+## Ability Development Guidelines
+
+1. Use the Vincent Ability SDK to create abilities
+2. Define clear schemas for ability parameters
+3. Implement the ability lifecycle methods (precheck, execute)
+4. Handle errors gracefully
+5. Write comprehensive tests for all functionality
+6. Document the ability's purpose and usage
+
+## Integration with Policies
+
+This ability can be integrated with various Vincent Policies to enforce constraints. When developing or modifying the ability, consider how it will be used with policies such as:
+
+- Vincent Policy Spending Limit
+
+## Testing
+
+Write unit tests for all functionality:
+
+```bash
+pnpm test
+```
+
+## Documentation
+
+- Document the ability's purpose and usage
+- Update README.md when adding new features
+- Document the ability's parameters and behavior
+
+## Pull Request Process
+
+1. Ensure your code follows the coding standards
+2. Update documentation if necessary
+3. Include tests for new functionality
+4. Link any related issues in your pull request description
+5. Request a review from a maintainer
+
+## Additional Resources
+
+- [Vincent Documentation](https://docs.heyvincent.ai/)
+- [Vincent Ability SDK Documentation](../../libs/ability-sdk/README.md)
+- [ERC20 Standard](https://eips.ethereum.org/EIPS/eip-20)

package/README.md

@@ -0,0 +1,76 @@
+# Vincent Ability ERC20 Approval
+
+An ability to send ERC20 approve/allowance transactions from a Vincent app on behalf of the delegator.
+
+## Overview
+
+The Vincent Ability ERC20 Approval is part of the Vincent Abilities ecosystem and is built using the Vincent Ability SDK. It allows Vincent apps to request and manage ERC20 token approvals on behalf of users, enabling seamless integration with DeFi protocols and other token-based applications.
+
+## Features
+
+- Request ERC20 token approvals for users
+- Set specific allowance amounts
+- Revoke existing approvals
+- Support for multiple ERC20 tokens
+
+## Installation
+
+```bash
+npm install @lit-protocol/vincent-ability-erc20-approval
+```
+
+## Usage
+
+This ability can be used in Vincent apps to manage ERC20 approvals:
+
+```typescript
+import { getVincentAbilityClient } from '@lit-protocol/vincent-app-sdk/abilityClient';
+import { bundledVincentAbility } from '@lit-protocol/vincent-ability-erc20-approval';
+
+// One of delegatee signers from your app's Vincent Dashboard
+const delegateeSigner = new ethers.Wallet('YOUR_DELEGATEE_PRIVATE_KEY');
+
+// Initialize the Vincent Ability Client
+const abilityClient = getVincentAbilityClient({
+  ethersSigner: delegateeSigner,
+  bundledVincentAbility,
+});
+const delegatorPkpEthAddress = '0x09182301238'; // The delegator PKP Eth Address
+
+const abilityParams = {
+  chainId: '8453', // The chain where the tx will be executed
+  tokenIn: '0x1234...', // The ERC20 token address
+  amountIn: '1000000000000000000', // The amount to approve (in wei)
+  rpcUrl: 'https://mainnet.base.org', // The RPC to send the transaction through
+};
+
+// Run precheck to see if ability should be executed
+const precheckResult = await client.precheck(abilityParams, {
+  delegatorPkpEthAddress,
+});
+
+if (precheckResult.success === true) {
+  // Execute the Vincent Ability
+  const executeResult = await client.execute(abilityParams, {
+    delegatorPkpEthAddress,
+  });
+
+  // ...ability has executed, you can check `executeResult` for details
+}
+```
+
+## Building
+
+Run `nx build ability-erc20-approval` to build the library.
+
+## Running unit tests
+
+Run `nx test ability-erc20-approval` to execute the unit tests via [Jest](https://jestjs.io).
+
+## Contributing
+
+Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on how to contribute to this project.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

package/dist/CHANGELOG.md

@@ -0,0 +1,14 @@
+## 1.0.2 (2025-07-08)
+
+### 🩹 Fixes
+
+- - Fixed `fail` results being returned as `success` in some cases ([867a2f85](https://github.com/LIT-Protocol/Vincent/commit/867a2f85))
+
+### 🧱 Updated Dependencies
+
+- Updated ability-sdk to 1.0.2
+- Updated app-sdk to 1.0.2
+
+### ❤️ Thank You
+
+- Daryl Collins

package/dist/CONTRIBUTING.md

@@ -0,0 +1,89 @@
+# Contributing to Vincent Ability ERC20 Approval
+
+This document provides guidelines for contributing to the Vincent Ability ERC20 Approval project.
+
+## Overview
+
+The Vincent Ability ERC20 Approval is an ability to send ERC20 approve/allowance transactions from a Vincent app on behalf of the delegator. It's part of the Vincent Abilities ecosystem and is built using the Vincent Ability SDK.
+
+## Setup
+
+1. Follow the global setup instructions in the repository root [CONTRIBUTING.md](../../../CONTRIBUTING.md).
+2. Install dependencies:
+   ```bash
+   pnpm install
+   ```
+
+## Development Workflow
+
+### Testing
+
+Run tests:
+
+```bash
+nx test ability-erc20-approval
+```
+
+### Building the Lit Action
+
+Build the tool:
+
+```bash
+nx action:build ability-erc20-approval
+```
+
+### Deploying the Lit Action to IPFS
+
+Building will be done automatically. Deploy the tool:
+
+```bash
+nx action:deploy ability-erc20-approval
+```
+
+## Project Structure
+
+- `src/`: Source code
+  - `index.ts`: Main entry point
+
+## Ability Development Guidelines
+
+1. Use the Vincent Ability SDK to create abilities
+2. Define clear schemas for ability parameters
+3. Implement the ability lifecycle methods (precheck, execute)
+4. Handle errors gracefully
+5. Write comprehensive tests for all functionality
+6. Document the ability's purpose and usage
+
+## Integration with Policies
+
+This ability can be integrated with various Vincent Policies to enforce constraints. When developing or modifying the ability, consider how it will be used with policies such as:
+
+- Vincent Policy Spending Limit
+
+## Testing
+
+Write unit tests for all functionality:
+
+```bash
+pnpm test
+```
+
+## Documentation
+
+- Document the ability's purpose and usage
+- Update README.md when adding new features
+- Document the ability's parameters and behavior
+
+## Pull Request Process
+
+1. Ensure your code follows the coding standards
+2. Update documentation if necessary
+3. Include tests for new functionality
+4. Link any related issues in your pull request description
+5. Request a review from a maintainer
+
+## Additional Resources
+
+- [Vincent Documentation](https://docs.heyvincent.ai/)
+- [Vincent Ability SDK Documentation](../../libs/ability-sdk/README.md)
+- [ERC20 Standard](https://eips.ethereum.org/EIPS/eip-20)

package/dist/README.md

@@ -0,0 +1,76 @@
+# Vincent Ability ERC20 Approval
+
+An ability to send ERC20 approve/allowance transactions from a Vincent app on behalf of the delegator.
+
+## Overview
+
+The Vincent Ability ERC20 Approval is part of the Vincent Abilities ecosystem and is built using the Vincent Ability SDK. It allows Vincent apps to request and manage ERC20 token approvals on behalf of users, enabling seamless integration with DeFi protocols and other token-based applications.
+
+## Features
+
+- Request ERC20 token approvals for users
+- Set specific allowance amounts
+- Revoke existing approvals
+- Support for multiple ERC20 tokens
+
+## Installation
+
+```bash
+npm install @lit-protocol/vincent-ability-erc20-approval
+```
+
+## Usage
+
+This ability can be used in Vincent apps to manage ERC20 approvals:
+
+```typescript
+import { getVincentAbilityClient } from '@lit-protocol/vincent-app-sdk/abilityClient';
+import { bundledVincentAbility } from '@lit-protocol/vincent-ability-erc20-approval';
+
+// One of delegatee signers from your app's Vincent Dashboard
+const delegateeSigner = new ethers.Wallet('YOUR_DELEGATEE_PRIVATE_KEY');
+
+// Initialize the Vincent Ability Client
+const abilityClient = getVincentAbilityClient({
+  ethersSigner: delegateeSigner,
+  bundledVincentAbility,
+});
+const delegatorPkpEthAddress = '0x09182301238'; // The delegator PKP Eth Address
+
+const abilityParams = {
+  chainId: '8453', // The chain where the tx will be executed
+  tokenIn: '0x1234...', // The ERC20 token address
+  amountIn: '1000000000000000000', // The amount to approve (in wei)
+  rpcUrl: 'https://mainnet.base.org', // The RPC to send the transaction through
+};
+
+// Run precheck to see if ability should be executed
+const precheckResult = await client.precheck(abilityParams, {
+  delegatorPkpEthAddress,
+});
+
+if (precheckResult.success === true) {
+  // Execute the Vincent Ability
+  const executeResult = await client.execute(abilityParams, {
+    delegatorPkpEthAddress,
+  });
+
+  // ...ability has executed, you can check `executeResult` for details
+}
+```
+
+## Building
+
+Run `nx build ability-erc20-approval` to build the library.
+
+## Running unit tests
+
+Run `nx test ability-erc20-approval` to execute the unit tests via [Jest](https://jestjs.io).
+
+## Contributing
+
+Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on how to contribute to this project.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

package/dist/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@lit-protocol/vincent-ability-erc20-approval",
+  "version": "1.0.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@lit-protocol/vincent-ability-sdk": "workspace:*",
+    "ethers": "^5.8.0",
+    "tslib": "2.8.1",
+    "zod": "^3.25.64"
+  },
+  "peerDependencies": {
+    "@lit-protocol/vincent-app-sdk": "workspace:^"
+  },
+  "devDependencies": {
+    "esbuild": "^0.19.12",
+    "esbuild-plugin-polyfill-node": "^0.3.0",
+    "ipfs-only-hash": "^4.0.0"
+  },
+  "main": "./dist/src/index.js",
+  "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist/**",
+    "*.md"
+  ],
+  "type": "commonjs"
+}