@envarai/envarpay 0.1.0-alpha.2 → 0.2.0-alpha.1

package/examples/envar-integration-policy.json

@@ -0,0 +1,18 @@
+{
+  "enabled": true,
+  "platformOrigin": "https://envar.ai",
+  "agentId": "54fe760a-4580-4258-9002-80f34c0d757a",
+  "runtimeAgentId": "hermes-researcher",
+  "acceptUpdates": true,
+  "allowedServices": ["research"],
+  "allowedUpstreamOrigins": ["http://hermes:9000"],
+  "allowedX402": [
+    {
+      "network": "eip155:84532",
+      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+      "payTo": "0x2222222222222222222222222222222222222222",
+      "facilitatorOrigin": "https://facilitator.example"
+    }
+  ],
+  "allowedMppAccounts": ["seller-stripe"]
+}

package/examples/seller.json

@@ -0,0 +1,52 @@
+{
+  "configVersion": 1,
+  "agent": {"id": "hermes-researcher", "name": "我的研究助手"},
+  "paymentProfiles": {
+    "base-usdc": {
+      "adapter": "x402", "scheme": "exact", "network": "eip155:84532",
+      "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+      "payTo": "0x2222222222222222222222222222222222222222",
+      "facilitatorUrl": "https://facilitator.example"
+    },
+    "stripe-usd": {"adapter": "mpp", "method": "stripe", "intent": "charge", "currency": "usd", "accountRef": "seller-stripe"}
+  },
+  "services": [
+    {
+      "id": "research", "name": "竞品调研", "revision": 1,
+      "execution": {"type": "a2a", "cardUrl": "http://hermes:9000/research/agent-card.json"},
+      "contract": {
+        "inputSchema": {
+          "$schema": "https://json-schema.org/draft/2020-12/schema",
+          "type": "object", "additionalProperties": false, "required": ["topic", "competitors"],
+          "properties": {
+            "topic": {"type": "string", "minLength": 1, "maxLength": 500},
+            "competitors": {"type": "array", "minItems": 1, "maxItems": 3, "uniqueItems": true, "items": {"type": "string", "minLength": 1, "maxLength": 120}}
+          }
+        },
+        "deliverables": ["report.md", "comparison.csv"], "targetDurationSeconds": 600, "includedRevisions": 0
+      },
+      "offers": [
+        {"id": "usdc-once", "pricing": {"kind": "fixed", "amount": "3000000"}, "collection": {"kind": "upfront"}, "paymentProfile": "base-usdc"},
+        {"id": "card-once", "pricing": {"kind": "fixed", "amount": "300"}, "collection": {"kind": "upfront"}, "paymentProfile": "stripe-usd"}
+      ]
+    },
+    {
+      "id": "summary-preview", "name": "免费试读", "revision": 1,
+      "execution": {"type": "a2a", "cardUrl": "http://hermes:9000/preview/agent-card.json"},
+      "contract": {
+        "inputSchema": {"type": "object", "additionalProperties": false, "required": ["text"], "properties": {"text": {"type": "string", "minLength": 1, "maxLength": 500}}},
+        "deliverables": ["summary.txt"], "targetDurationSeconds": 60, "includedRevisions": 0
+      },
+      "offers": [{"id": "free", "pricing": {"kind": "free"}, "collection": {"kind": "none"}}]
+    },
+    {
+      "id": "translation", "name": "文档翻译", "revision": 1,
+      "execution": {"type": "a2a", "cardUrl": "http://openclaw:9000/translate/agent-card.json"},
+      "contract": {
+        "inputSchema": {"type": "object", "additionalProperties": false, "required": ["documents"], "properties": {"documents": {"type": "array", "minItems": 1, "maxItems": 20, "items": {"type": "string", "minLength": 1, "maxLength": 10000}}}},
+        "deliverables": ["translations.json"], "targetDurationSeconds": 600, "includedRevisions": 0
+      },
+      "offers": [{"id": "per-document", "pricing": {"kind": "quantity", "unit": "document", "unitAmount": "100000", "quantity": {"pointer": "/documents", "measure": "count", "min": 1, "max": 20}}, "collection": {"kind": "upfront"}, "paymentProfile": "base-usdc"}]
+    }
+  ]
+}

package/package.json

@@ -1,15 +1,80 @@
 {
   "name": "@envarai/envarpay",
-  "version": "0.1.0-alpha.2",
-  "description": "Typed MCP client for an operator-configured EnvarPay wallet service",
+  "version": "0.2.0-alpha.1",
+  "description": "Independent A2A service commerce, budgeted buyers and x402/MPP payments",
   "type": "module",
   "license": "MIT",
-  "engines": { "node": ">=22.14.0" },
-  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
-  "files": ["dist", "README.md", "LICENSE"],
-  "repository": { "type": "git", "url": "git+https://github.com/EnvarAI/EnvarPay.git", "directory": "packages/typescript" },
-  "publishConfig": { "access": "public", "tag": "next" },
-  "scripts": { "build": "tsc", "test": "npm run build && node --test test/client.test.mjs", "prepack": "npm run build" },
-  "dependencies": { "@modelcontextprotocol/sdk": "^1.31.0" },
-  "devDependencies": { "typescript": "~5.9.3", "@types/node": "^22.0.0" }
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/commerce/index.d.ts",
+      "import": "./dist/commerce/index.js"
+    },
+    "./commerce": {
+      "types": "./dist/commerce/index.d.ts",
+      "import": "./dist/commerce/index.js"
+    },
+    "./commerce/server": {
+      "types": "./dist/commerce/runtime.d.ts",
+      "import": "./dist/commerce/runtime.js"
+    },
+    "./client": {
+      "types": "./dist/commerce/client-runtime.d.ts",
+      "import": "./dist/commerce/client-runtime.js"
+    },
+    "./server": {
+      "types": "./dist/commerce/runtime.d.ts",
+      "import": "./dist/commerce/runtime.js"
+    },
+    "./mpp": {
+      "types": "./dist/commerce/mpp-runtime.d.ts",
+      "import": "./dist/commerce/mpp-runtime.js"
+    },
+    "./envar": {
+      "types": "./dist/commerce/envar.d.ts",
+      "import": "./dist/commerce/envar.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "schemas",
+    "examples"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EnvarAI/EnvarPay.git",
+    "directory": "packages/typescript"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "1.2.1",
+    "@modelcontextprotocol/sdk": "^1.31.0",
+    "@x402/core": "2.24.0",
+    "@x402/evm": "2.24.0",
+    "@x402/extensions": "2.24.0",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "canonicalize": "2.1.0",
+    "mppx": "0.13.1",
+    "viem": "2.57.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "~5.9.3"
+  },
+  "bin": {
+    "envarpay": "dist/commerce/cli.js"
+  }
 }

package/schemas/buyer-policy.schema.json

@@ -0,0 +1,148 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:envarpay:buyer-policy:1",
+  "title": "Local buyer permission policy; not supplied by the seller",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "policyVersion",
+    "paymentsEnabled",
+    "approval",
+    "peers",
+    "budgets"
+  ],
+  "properties": {
+    "policyVersion": {
+      "const": 1
+    },
+    "paymentsEnabled": {
+      "type": "boolean"
+    },
+    "approval": {
+      "enum": [
+        "per_purchase",
+        "within_preapproved_limits"
+      ]
+    },
+    "peers": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "cardUrl",
+          "protocol",
+          "currency",
+          "recipient",
+          "maxPerPurchase"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]{0,63}$"
+          },
+          "cardUrl": {
+            "type": "string",
+            "format": "uri",
+            "pattern": "^https://"
+          },
+          "protocol": {
+            "enum": [
+              "x402",
+              "mpp",
+              "free"
+            ]
+          },
+          "currency": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "recipient": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "maxPerPurchase": {
+            "type": "string",
+            "pattern": "^(0|[1-9][0-9]{0,77})$"
+          }
+        },
+        "allOf": [
+          {
+            "if": {
+              "properties": {
+                "protocol": {
+                  "const": "free"
+                }
+              }
+            },
+            "then": {
+              "properties": {
+                "currency": {
+                  "const": null
+                },
+                "recipient": {
+                  "const": null
+                },
+                "maxPerPurchase": {
+                  "const": "0"
+                }
+              }
+            },
+            "else": {
+              "properties": {
+                "currency": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "recipient": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "maxPerPurchase": {
+                  "$ref": "#/$defs/amount"
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    "budgets": {
+      "type": "array",
+      "minItems": 0,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "currency",
+          "maxTotal",
+          "period"
+        ],
+        "properties": {
+          "currency": {
+            "type": "string",
+            "minLength": 1
+          },
+          "maxTotal": {
+            "$ref": "#/$defs/amount"
+          },
+          "period": {
+            "const": "cumulative"
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "amount": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]{0,77}$"
+    }
+  }
+}

package/schemas/envarpay.config.schema.json

@@ -0,0 +1,376 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:envarpay:config:1",
+  "title": "EnvarPay A2A commerce MVP configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "configVersion",
+    "agent",
+    "paymentProfiles",
+    "services"
+  ],
+  "properties": {
+    "configVersion": {
+      "const": 1
+    },
+    "agent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 120
+        }
+      }
+    },
+    "paymentProfiles": {
+      "type": "object",
+      "maxProperties": 16,
+      "propertyNames": {
+        "$ref": "#/$defs/id"
+      },
+      "additionalProperties": {
+        "oneOf": [
+          {
+            "$ref": "#/$defs/x402"
+          },
+          {
+            "$ref": "#/$defs/mpp"
+          }
+        ]
+      }
+    },
+    "services": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "items": {
+        "$ref": "#/$defs/service"
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,63}$"
+    },
+    "amount": {
+      "type": "string",
+      "pattern": "^[1-9][0-9]{0,77}$"
+    },
+    "address": {
+      "type": "string",
+      "pattern": "^0x[0-9a-fA-F]{40}$"
+    },
+    "httpUrl": {
+      "type": "string",
+      "format": "uri",
+      "pattern": "^https?://",
+      "maxLength": 2048
+    },
+    "x402": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "adapter",
+        "scheme",
+        "network",
+        "asset",
+        "payTo",
+        "facilitatorUrl"
+      ],
+      "properties": {
+        "adapter": {
+          "const": "x402"
+        },
+        "scheme": {
+          "const": "exact"
+        },
+        "network": {
+          "type": "string",
+          "pattern": "^eip155:[1-9][0-9]*$"
+        },
+        "asset": {
+          "$ref": "#/$defs/address"
+        },
+        "payTo": {
+          "$ref": "#/$defs/address"
+        },
+        "facilitatorUrl": {
+          "type": "string",
+          "format": "uri",
+          "pattern": "^https://"
+        }
+      }
+    },
+    "mpp": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "adapter",
+        "method",
+        "intent",
+        "currency",
+        "accountRef"
+      ],
+      "properties": {
+        "adapter": {
+          "const": "mpp"
+        },
+        "method": {
+          "const": "stripe"
+        },
+        "intent": {
+          "const": "charge"
+        },
+        "currency": {
+          "const": "usd"
+        },
+        "accountRef": {
+          "$ref": "#/$defs/id"
+        }
+      }
+    },
+    "service": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "name",
+        "revision",
+        "execution",
+        "contract",
+        "offers"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2147483647
+        },
+        "execution": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "type",
+            "cardUrl"
+          ],
+          "properties": {
+            "type": {
+              "const": "a2a"
+            },
+            "cardUrl": {
+              "$ref": "#/$defs/httpUrl"
+            }
+          }
+        },
+        "contract": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "inputSchema",
+            "deliverables",
+            "targetDurationSeconds",
+            "includedRevisions"
+          ],
+          "properties": {
+            "inputSchema": {
+              "type": "object"
+            },
+            "deliverables": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "targetDurationSeconds": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 86400
+            },
+            "includedRevisions": {
+              "const": 0
+            }
+          }
+        },
+        "offers": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 16,
+          "items": {
+            "$ref": "#/$defs/offer"
+          }
+        }
+      }
+    },
+    "free": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind"
+      ],
+      "properties": {
+        "kind": {
+          "const": "free"
+        }
+      }
+    },
+    "fixed": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "amount"
+      ],
+      "properties": {
+        "kind": {
+          "const": "fixed"
+        },
+        "amount": {
+          "$ref": "#/$defs/amount"
+        }
+      }
+    },
+    "quantity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "unit",
+        "unitAmount",
+        "quantity"
+      ],
+      "properties": {
+        "kind": {
+          "const": "quantity"
+        },
+        "unit": {
+          "$ref": "#/$defs/id"
+        },
+        "unitAmount": {
+          "$ref": "#/$defs/amount"
+        },
+        "quantity": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "pointer",
+            "measure",
+            "min",
+            "max"
+          ],
+          "properties": {
+            "pointer": {
+              "type": "string",
+              "pattern": "^(/([^~/]|~[01])*)+$"
+            },
+            "measure": {
+              "const": "count"
+            },
+            "min": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "max": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 10000
+            }
+          }
+        }
+      }
+    },
+    "offer": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "pricing",
+            "collection"
+          ],
+          "properties": {
+            "id": {
+              "$ref": "#/$defs/id"
+            },
+            "pricing": {
+              "$ref": "#/$defs/free"
+            },
+            "collection": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "kind"
+              ],
+              "properties": {
+                "kind": {
+                  "const": "none"
+                }
+              }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "pricing",
+            "collection",
+            "paymentProfile"
+          ],
+          "properties": {
+            "id": {
+              "$ref": "#/$defs/id"
+            },
+            "pricing": {
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/fixed"
+                },
+                {
+                  "$ref": "#/$defs/quantity"
+                }
+              ]
+            },
+            "collection": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "kind"
+              ],
+              "properties": {
+                "kind": {
+                  "const": "upfront"
+                }
+              }
+            },
+            "paymentProfile": {
+              "$ref": "#/$defs/id"
+            }
+          }
+        }
+      ]
+    }
+  }
+}