@paystage/mcp 0.0.0-stage → 0.2.0
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/README.md +90 -2
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +8 -0
- package/dist/cli.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -0
- package/dist/server.d.ts +7 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +176 -0
- package/dist/server.js.map +1 -0
- package/package.json +57 -4
- package/server.json +36 -0
package/README.md
CHANGED
|
@@ -1,3 +1,91 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @paystage/mcp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
PayStage umbrella MCP server: payment preflight, auth watch, and HIP-3 trade preflight.
|
|
4
|
+
|
|
5
|
+
> Not financial advice. The trade preflight tool is a local policy gate only — it does not
|
|
6
|
+
> place orders or recommend trades.
|
|
7
|
+
|
|
8
|
+
Published on npm as **`@paystage/mcp@0.2.0`**.
|
|
9
|
+
|
|
10
|
+
## Install
|
|
11
|
+
|
|
12
|
+
```sh
|
|
13
|
+
npx -y @paystage/mcp
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Or:
|
|
17
|
+
|
|
18
|
+
```sh
|
|
19
|
+
npm install @paystage/mcp
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
The package exposes a `stdio` MCP server (bin: `paystage-mcp`).
|
|
23
|
+
|
|
24
|
+
## MCP configuration
|
|
25
|
+
|
|
26
|
+
```json
|
|
27
|
+
{
|
|
28
|
+
"mcpServers": {
|
|
29
|
+
"paystage": {
|
|
30
|
+
"command": "npx",
|
|
31
|
+
"args": ["-y", "@paystage/mcp"],
|
|
32
|
+
"env": {
|
|
33
|
+
"PAYSTAGE_POLICY_PATH": "./policy.json"
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Environment variables (all optional):
|
|
41
|
+
|
|
42
|
+
- `PAYSTAGE_POLICY_PATH` — path to `policy.json` spending rules
|
|
43
|
+
- `PAYSTAGE_RPC_URL` — Base RPC URL override
|
|
44
|
+
|
|
45
|
+
## Tools
|
|
46
|
+
|
|
47
|
+
### `evaluate_mcp_payment` — Available now
|
|
48
|
+
|
|
49
|
+
Evaluates a proposed x402 payment against a local policy file and returns a verdict before
|
|
50
|
+
the agent signs anything.
|
|
51
|
+
|
|
52
|
+
### `list_outstanding_auths` — Available now
|
|
53
|
+
|
|
54
|
+
Lists outstanding ERC-20, Permit2, and EIP-3009 authorizations.
|
|
55
|
+
|
|
56
|
+
### `evaluate_outstanding_auths` — Available now
|
|
57
|
+
|
|
58
|
+
Flags outstanding authorizations that need attention (e.g. authorized but never settled).
|
|
59
|
+
|
|
60
|
+
### `evaluate_hip3_trade` — Available now
|
|
61
|
+
|
|
62
|
+
Evaluates a proposed HIP-3 / trade.xyz order against a local `TradePolicy` and returns a
|
|
63
|
+
decision: `allow` | `review` | `do_not_trade`.
|
|
64
|
+
|
|
65
|
+
Backed by [`@paystage/trade-preflight`](https://www.npmjs.com/package/@paystage/trade-preflight)
|
|
66
|
+
(`0.1.0`), which is also published on npm and can be run standalone:
|
|
67
|
+
|
|
68
|
+
```sh
|
|
69
|
+
npx -y @paystage/trade-preflight
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
The policy is passed as a tool argument; no extra environment variables are required for
|
|
73
|
+
this tool.
|
|
74
|
+
|
|
75
|
+
## Packages
|
|
76
|
+
|
|
77
|
+
| Package | Version | Purpose |
|
|
78
|
+
| --- | --- | --- |
|
|
79
|
+
| `@paystage/mcp` | 0.2.0 | Umbrella server (4 tools) |
|
|
80
|
+
| `@paystage/auth-watch` | 0.1.0 | Outstanding-auth tools |
|
|
81
|
+
| `@paystage/trade-preflight` | 0.1.2 | HIP-3 / trade.xyz trade preflight |
|
|
82
|
+
|
|
83
|
+
## Links
|
|
84
|
+
|
|
85
|
+
- Website: [paystage.xyz](https://paystage.xyz)
|
|
86
|
+
- HIP-3 context: [docs.trade.xyz](https://docs.trade.xyz)
|
|
87
|
+
- Source: [github.com/base-buzz/paystage](https://github.com/base-buzz/paystage)
|
|
88
|
+
|
|
89
|
+
## License
|
|
90
|
+
|
|
91
|
+
MIT
|
package/dist/cli.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}
|
package/dist/cli.js
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { startServer } from "./server.js";
|
|
3
|
+
startServer().catch((error) => {
|
|
4
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
5
|
+
process.stderr.write(`paystage-mcp fatal: ${message}\n`);
|
|
6
|
+
process.exit(1);
|
|
7
|
+
});
|
|
8
|
+
//# sourceMappingURL=cli.js.map
|
package/dist/cli.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,OAAO,IAAI,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
|
package/dist/server.d.ts
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
export declare const TOOL_NAMES: readonly ["evaluate_mcp_payment", "list_outstanding_auths", "evaluate_outstanding_auths", "evaluate_hip3_trade"];
|
|
3
|
+
export type ToolName = (typeof TOOL_NAMES)[number];
|
|
4
|
+
export declare function createServer(): McpServer;
|
|
5
|
+
export declare function getToolNames(): string[];
|
|
6
|
+
export declare function startServer(): Promise<void>;
|
|
7
|
+
//# sourceMappingURL=server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BpE,eAAO,MAAM,UAAU,kHAKb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAqNnD,wBAAgB,YAAY,IAAI,SAAS,CAOxC;AAED,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}
|
package/dist/server.js
ADDED
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
3
|
+
import { z } from "zod";
|
|
4
|
+
import { loadPolicy, parsePolicy } from "@paystage/policy";
|
|
5
|
+
import { evaluatePayment, normalizePaymentRequired, } from "@paystage/preflight";
|
|
6
|
+
import { listOutstandingAuths, evaluateOutstandingAuths, createRpcClient, resolveRpcUrl, } from "@paystage/auth-watch";
|
|
7
|
+
import { evaluateTrade, parseTradePolicy, fetchMetaAndAssetCtxs, } from "@paystage/trade-preflight";
|
|
8
|
+
export const TOOL_NAMES = [
|
|
9
|
+
"evaluate_mcp_payment",
|
|
10
|
+
"list_outstanding_auths",
|
|
11
|
+
"evaluate_outstanding_auths",
|
|
12
|
+
"evaluate_hip3_trade",
|
|
13
|
+
];
|
|
14
|
+
const DEFAULT_NETWORK = "base";
|
|
15
|
+
async function resolvePolicy(input) {
|
|
16
|
+
if (input.policy !== undefined) {
|
|
17
|
+
return parsePolicy(input.policy);
|
|
18
|
+
}
|
|
19
|
+
const path = input.policy_path ?? process.env.PAYSTAGE_POLICY_PATH ?? "./policy.json";
|
|
20
|
+
return await loadPolicy(path);
|
|
21
|
+
}
|
|
22
|
+
function tokensForNetwork(policy, network) {
|
|
23
|
+
const tokens = policy.tokens;
|
|
24
|
+
return tokens?.[network] ?? [];
|
|
25
|
+
}
|
|
26
|
+
function spendersForPolicy(policy) {
|
|
27
|
+
const spenders = policy.spenders;
|
|
28
|
+
return spenders ?? [];
|
|
29
|
+
}
|
|
30
|
+
const authWatchShape = {
|
|
31
|
+
wallet: z.string(),
|
|
32
|
+
network: z.string().optional(),
|
|
33
|
+
tokens: z.array(z.string()).optional(),
|
|
34
|
+
spenders: z.array(z.string()).optional(),
|
|
35
|
+
policy_path: z.string().optional(),
|
|
36
|
+
policy: z.unknown().optional(),
|
|
37
|
+
eip3009_nonces: z.array(z.string()).optional(),
|
|
38
|
+
rpc_url: z.string().optional(),
|
|
39
|
+
};
|
|
40
|
+
const tradeProposalShape = z.object({
|
|
41
|
+
dex: z.string(),
|
|
42
|
+
asset: z.string(),
|
|
43
|
+
side: z.enum(["buy", "sell"]),
|
|
44
|
+
size: z.string(),
|
|
45
|
+
leverage: z.number().optional(),
|
|
46
|
+
order_type: z.enum(["limit", "market"]).optional(),
|
|
47
|
+
limit_px: z.string().optional(),
|
|
48
|
+
});
|
|
49
|
+
function registerAllTools(server) {
|
|
50
|
+
server.registerTool("evaluate_mcp_payment", {
|
|
51
|
+
description: "Evaluate an x402 PaymentRequired payload against a PayStage spending policy before paying",
|
|
52
|
+
inputSchema: {
|
|
53
|
+
payment_required: z.unknown(),
|
|
54
|
+
policy_path: z.string().optional(),
|
|
55
|
+
policy: z.unknown().optional(),
|
|
56
|
+
},
|
|
57
|
+
}, async (input) => {
|
|
58
|
+
try {
|
|
59
|
+
const policy = await resolvePolicy(input);
|
|
60
|
+
const pr = normalizePaymentRequired(input.payment_required);
|
|
61
|
+
const result = evaluatePayment(pr, policy);
|
|
62
|
+
return {
|
|
63
|
+
content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
catch (error) {
|
|
67
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
68
|
+
return {
|
|
69
|
+
isError: true,
|
|
70
|
+
content: [{ type: "text", text: `Error: ${message}` }],
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
});
|
|
74
|
+
server.tool("list_outstanding_auths", "List outstanding token authorizations for a wallet", authWatchShape, async (args) => {
|
|
75
|
+
const policy = await resolvePolicy(args);
|
|
76
|
+
const network = args.network ?? DEFAULT_NETWORK;
|
|
77
|
+
const tokens = args.tokens ?? tokensForNetwork(policy, network);
|
|
78
|
+
const spenders = args.spenders ?? spendersForPolicy(policy);
|
|
79
|
+
const rpcUrl = args.rpc_url ?? resolveRpcUrl(network);
|
|
80
|
+
const rpc = createRpcClient(rpcUrl);
|
|
81
|
+
const items = await listOutstandingAuths({
|
|
82
|
+
wallet: args.wallet,
|
|
83
|
+
network,
|
|
84
|
+
tokens,
|
|
85
|
+
spenders,
|
|
86
|
+
rpc,
|
|
87
|
+
eip3009Nonces: args.eip3009_nonces,
|
|
88
|
+
});
|
|
89
|
+
const serialized = items.map((i) => ({
|
|
90
|
+
...i,
|
|
91
|
+
amount: i.amount.toString(),
|
|
92
|
+
}));
|
|
93
|
+
return {
|
|
94
|
+
content: [
|
|
95
|
+
{
|
|
96
|
+
type: "text",
|
|
97
|
+
text: JSON.stringify({ items: serialized }, null, 2),
|
|
98
|
+
},
|
|
99
|
+
],
|
|
100
|
+
};
|
|
101
|
+
});
|
|
102
|
+
server.tool("evaluate_outstanding_auths", "List and evaluate outstanding token authorizations against a policy", authWatchShape, async (args) => {
|
|
103
|
+
const policy = await resolvePolicy(args);
|
|
104
|
+
const network = args.network ?? DEFAULT_NETWORK;
|
|
105
|
+
const tokens = args.tokens ?? tokensForNetwork(policy, network);
|
|
106
|
+
const spenders = args.spenders ?? spendersForPolicy(policy);
|
|
107
|
+
const rpcUrl = args.rpc_url ?? resolveRpcUrl(network);
|
|
108
|
+
const rpc = createRpcClient(rpcUrl);
|
|
109
|
+
const items = await listOutstandingAuths({
|
|
110
|
+
wallet: args.wallet,
|
|
111
|
+
network,
|
|
112
|
+
tokens,
|
|
113
|
+
spenders,
|
|
114
|
+
rpc,
|
|
115
|
+
eip3009Nonces: args.eip3009_nonces,
|
|
116
|
+
});
|
|
117
|
+
const results = evaluateOutstandingAuths(items, policy);
|
|
118
|
+
const serialized = results.map((r) => ({
|
|
119
|
+
item: { ...r.item, amount: r.item.amount.toString() },
|
|
120
|
+
flags: r.flags,
|
|
121
|
+
summary: r.summary,
|
|
122
|
+
}));
|
|
123
|
+
return {
|
|
124
|
+
content: [
|
|
125
|
+
{
|
|
126
|
+
type: "text",
|
|
127
|
+
text: JSON.stringify({ results: serialized }, null, 2),
|
|
128
|
+
},
|
|
129
|
+
],
|
|
130
|
+
};
|
|
131
|
+
});
|
|
132
|
+
server.registerTool("evaluate_hip3_trade", {
|
|
133
|
+
description: "Evaluate a Hyperliquid HIP-3 (trade.xyz) order against a TradePolicy before an agent trades. Returns decision allow | review | do_not_trade.",
|
|
134
|
+
inputSchema: {
|
|
135
|
+
proposal: tradeProposalShape,
|
|
136
|
+
policy: z.unknown().optional(),
|
|
137
|
+
policy_path: z.string().optional(),
|
|
138
|
+
snapshot: z.unknown().optional(),
|
|
139
|
+
},
|
|
140
|
+
}, async (args) => {
|
|
141
|
+
try {
|
|
142
|
+
const policy = parseTradePolicy(args.policy);
|
|
143
|
+
const snapshot = args.snapshot !== undefined
|
|
144
|
+
? args.snapshot
|
|
145
|
+
: await fetchMetaAndAssetCtxs(args.proposal.dex || "xyz");
|
|
146
|
+
const result = evaluateTrade(args.proposal, snapshot, policy);
|
|
147
|
+
return {
|
|
148
|
+
content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
|
|
149
|
+
};
|
|
150
|
+
}
|
|
151
|
+
catch (error) {
|
|
152
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
153
|
+
return {
|
|
154
|
+
isError: true,
|
|
155
|
+
content: [{ type: "text", text: `Error: ${message}` }],
|
|
156
|
+
};
|
|
157
|
+
}
|
|
158
|
+
});
|
|
159
|
+
}
|
|
160
|
+
export function createServer() {
|
|
161
|
+
const server = new McpServer({
|
|
162
|
+
name: "paystage",
|
|
163
|
+
version: "0.1.0",
|
|
164
|
+
});
|
|
165
|
+
registerAllTools(server);
|
|
166
|
+
return server;
|
|
167
|
+
}
|
|
168
|
+
export function getToolNames() {
|
|
169
|
+
return [...TOOL_NAMES];
|
|
170
|
+
}
|
|
171
|
+
export async function startServer() {
|
|
172
|
+
const server = createServer();
|
|
173
|
+
const transport = new StdioServerTransport();
|
|
174
|
+
await server.connect(transport);
|
|
175
|
+
}
|
|
176
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,59 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@paystage/mcp",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"description": "PayStage umbrella MCP: payment preflight, auth watch, and HIP-3 trade preflight",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"bin": {
|
|
8
|
+
"paystage-mcp": "./dist/cli.js"
|
|
9
|
+
},
|
|
10
|
+
"files": [
|
|
11
|
+
"dist",
|
|
12
|
+
"server.json"
|
|
13
|
+
],
|
|
14
|
+
"mcpName": "xyz.paystage/mcp",
|
|
15
|
+
"engines": {
|
|
16
|
+
"node": ">=20"
|
|
17
|
+
},
|
|
18
|
+
"keywords": [
|
|
19
|
+
"mcp",
|
|
20
|
+
"x402",
|
|
21
|
+
"agent-payments",
|
|
22
|
+
"usdc",
|
|
23
|
+
"base",
|
|
24
|
+
"paystage",
|
|
25
|
+
"hip-3",
|
|
26
|
+
"trade"
|
|
27
|
+
],
|
|
28
|
+
"homepage": "https://paystage.xyz",
|
|
29
|
+
"repository": {
|
|
30
|
+
"type": "git",
|
|
31
|
+
"url": "git+https://github.com/base-buzz/paystage.git",
|
|
32
|
+
"directory": "packages/mcp"
|
|
33
|
+
},
|
|
34
|
+
"bugs": {
|
|
35
|
+
"url": "https://github.com/base-buzz/paystage/issues"
|
|
36
|
+
},
|
|
37
|
+
"publishConfig": {
|
|
38
|
+
"access": "public"
|
|
39
|
+
},
|
|
40
|
+
"dependencies": {
|
|
41
|
+
"@modelcontextprotocol/sdk": "^1.12.0",
|
|
42
|
+
"@paystage/policy": "0.1.0",
|
|
43
|
+
"@paystage/preflight": "0.1.0",
|
|
44
|
+
"@paystage/auth-watch": "0.1.0",
|
|
45
|
+
"@paystage/trade-preflight": "^0.1.2",
|
|
46
|
+
"zod": "^3.23.8"
|
|
47
|
+
},
|
|
48
|
+
"devDependencies": {
|
|
49
|
+
"@types/node": "^20.14.0",
|
|
50
|
+
"typescript": "^5.5.4",
|
|
51
|
+
"vitest": "^2.0.5"
|
|
52
|
+
},
|
|
53
|
+
"scripts": {
|
|
54
|
+
"build": "tsc",
|
|
55
|
+
"test": "vitest run",
|
|
56
|
+
"typecheck": "tsc --noEmit",
|
|
57
|
+
"prepublishOnly": "npm run build"
|
|
58
|
+
}
|
|
59
|
+
}
|
package/server.json
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
|
+
"name": "xyz.paystage/mcp",
|
|
4
|
+
"title": "PayStage",
|
|
5
|
+
"description": "PayStage umbrella: payment preflight, auth watch, and HIP-3 trade preflight",
|
|
6
|
+
"version": "0.2.0",
|
|
7
|
+
"websiteUrl": "https://paystage.xyz",
|
|
8
|
+
"repository": {
|
|
9
|
+
"url": "https://github.com/base-buzz/paystage",
|
|
10
|
+
"source": "github",
|
|
11
|
+
"subfolder": "packages/mcp"
|
|
12
|
+
},
|
|
13
|
+
"packages": [
|
|
14
|
+
{
|
|
15
|
+
"registryType": "npm",
|
|
16
|
+
"registryBaseUrl": "https://registry.npmjs.org",
|
|
17
|
+
"identifier": "@paystage/mcp",
|
|
18
|
+
"version": "0.2.0",
|
|
19
|
+
"transport": {
|
|
20
|
+
"type": "stdio"
|
|
21
|
+
},
|
|
22
|
+
"environmentVariables": [
|
|
23
|
+
{
|
|
24
|
+
"name": "PAYSTAGE_POLICY_PATH",
|
|
25
|
+
"description": "Path to policy.json spending rules",
|
|
26
|
+
"isRequired": false
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"name": "PAYSTAGE_RPC_URL",
|
|
30
|
+
"description": "Base RPC URL override",
|
|
31
|
+
"isRequired": false
|
|
32
|
+
}
|
|
33
|
+
]
|
|
34
|
+
}
|
|
35
|
+
]
|
|
36
|
+
}
|