n8n-nodes-arl 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 ARL Protocol (Alazdg)
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -16,6 +16,7 @@ step:
16
16
  | Reject Job | evaluator | Rejects it: the escrow refunds the client |
17
17
  | Claim Refund | anyone | After the deadline, returns the escrow to the client |
18
18
  | Get Job | anyone | Reads the job and its status |
19
+ | Open Task | client | Opens an [arl-task/1](https://github.com/armanalabsai/arlcoin.io/tree/main/spec/arl-task) task as a verified job, in one step |
19
20
 
20
21
  The evaluator is the wallet that creates the job unless you name another address.
21
22
 
@@ -31,12 +32,25 @@ The evaluator is the wallet that creates the job unless you name another address
31
32
  Each operation returns the job id and the transaction hash, so the next node can continue the
32
33
  flow (for example, Submit Work after an AI step, then Complete Job after a check).
33
34
 
35
+ ## Example workflow
36
+
37
+ [`examples/hire-an-agent.json`](./examples/hire-an-agent.json) is a ready-to-import workflow that
38
+ creates a job, sets its budget, funds it on the Base Mainnet escrow, waits for the provider's
39
+ submission, and either completes (paying the provider) or rejects (refunding the client) the job:
40
+
41
+ 1. In n8n, open a workflow and select **⋯ → Import from File…**, then choose
42
+ `examples/hire-an-agent.json`.
43
+ 2. Open the **Create Job** node and replace `0x1111111111111111111111111111111111111111` with the
44
+ provider's Base Mainnet address.
45
+ 3. Select your **ARL Wallet API** credential on each ARL node (never commit private keys into
46
+ workflow files).
47
+
34
48
  ## Contracts
35
49
 
36
50
  | Escrow | Address on Base Mainnet |
37
51
  | --------------- | -------------------------------------------- |
38
- | Paid in ARL | `0x4664d58FAFFb6ab1cf36717c70058a323E2A98f9` |
39
- | Paid in USDC | `0xc833140D2eE8607fd41662cffFAc557f3D535bE6` |
52
+ | Paid in ARL | `0x9aE99bF9a59aF47E81346B7c0b93Cd2B610455fC` |
53
+ | Paid in USDC | `0xE3eA0EAEc3Cf9DA2d0856A0f784A4B1671AeFD04` |
40
54
 
41
55
  ARL token: `0xde91E6f39D50bBd875f831dcc1134A3D7f3aaDb4`. Source and tests:
42
56
  [github.com/armanalabsai/arlcoin.io](https://github.com/armanalabsai/arlcoin.io).
@@ -50,6 +64,14 @@ ARL_FORK_RPC=http://127.0.0.1:18546 npm run test:fork # the full job lifecycle
50
64
  npm run build # dist/ with viem bundled: no runtime dependencies
51
65
  ```
52
66
 
53
- Verified jobs, where a committee of staked validators checks the work, come in a later version.
67
+ ## Verified jobs: Open Task
68
+
69
+ Open Task takes a task written as an arl-task/1 document, the link where anyone can fetch it, the
70
+ provider and a committee of staked validators. It checks the task against its policy first, so a
71
+ task the policy refuses sends nothing. Then the wallet creates the job on the task's escrow (ARL or
72
+ USDC, from the task's payment token), configures the committee, sets the budget, approves and funds
73
+ it. These are the same transactions the SDK, the MCP server and the Agent API
74
+ (`https://arlcoin.io/api/v1`) prepare. The provider approves the committee next, and the
75
+ validators check the work against the task.
54
76
 
55
- License: Apache-2.0.
77
+ License: MIT (this package only; the rest of the ARL repository is Apache-2.0).