You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: config/config.schema.yaml
+49-13Lines changed: 49 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -4,10 +4,14 @@
4
4
# To validate the config file, the following comment must be placed at the top of the .config.yaml file:
5
5
# <REMOVE THIS TAG> yaml-language-server: $schema=https://raw.githubusercontent.com/buildwithgrove/path/refs/heads/main/config/config.schema.yaml
6
6
7
+
description: "PATH Gateway Configuration YAML: this file is used to configure a PATH gateway for either Morse or Shannon."
7
8
type: object
8
9
additionalProperties: false
9
10
required:
10
11
- services
12
+
oneOf:
13
+
- required: ["morse_config"]
14
+
- required: ["shannon_config"]
11
15
12
16
properties:
13
17
# NOTE: Exactly one of either "morse_config" or "shannon_config" must be present
@@ -18,19 +22,23 @@ properties:
18
22
19
23
# Morse Configuration (required for Morse gateways)
20
24
morse_config:
25
+
description: "Configuration for the Morse gateway; if specified, the PATH instance will use the Morse version of the Pocket protocol."
21
26
type: object
22
27
additionalProperties: false
23
28
properties:
24
29
full_node_config:
30
+
description: "Configuration for the full node for Morse gateways. This configuration is used to connect to the Morse full node to get data from the Pocket blockchain."
25
31
type: object
26
32
additionalProperties: false
27
33
required:
28
34
- url
29
35
properties:
30
36
url:
37
+
description: "The URL of the full Morse Pocket node."
31
38
type: string
32
39
pattern: "^(http|https)://.*$"
33
40
relay_signing_key:
41
+
description: "The relay signing key for Morse gateways. This key is used to sign relays sent through the Morse gateway."
34
42
type: string
35
43
pattern: "^[0-9a-fA-F]{128}$"
36
44
http_config:
@@ -39,9 +47,12 @@ properties:
39
47
properties:
40
48
retries:
41
49
type: integer
50
+
description: "Number of retries for HTTP requests using the Pocket Go SDK. (optional, defaults to 0)"
42
51
timeout:
52
+
description: "Timeout duration for HTTP requests using the Pocket Go SDK. (optional, defaults to 5 seconds)"
43
53
type: string
44
54
transport:
55
+
description: "HTTP transport configuration for the Pocket Go SDK. (optional, sensible defaults are provided)"
45
56
type: object
46
57
additionalProperties: false
47
58
properties:
@@ -57,78 +68,88 @@ properties:
57
68
type: string
58
69
keep_alive:
59
70
type: string
60
-
request_config:
61
-
type: object
62
-
additionalProperties: false
63
-
properties:
64
-
retries:
65
-
type: integer
66
71
signed_aats:
67
72
type: object
68
73
additionalProperties: false
69
74
patternProperties:
70
75
"^[0-9a-fA-F]{40}$":
71
76
type: object
72
77
additionalProperties: false
78
+
required:
79
+
- client_public_key
80
+
- application_public_key
81
+
- application_signature
73
82
properties:
74
83
client_public_key:
84
+
description: "Client public key for the Morse AAT."
75
85
type: string
76
86
pattern: "^[0-9a-fA-F]{64}$"
77
87
application_public_key:
88
+
description: "Application public key for the Morse AAT."
78
89
type: string
79
90
pattern: "^[0-9a-fA-F]{64}$"
80
91
application_signature:
81
92
type: string
82
93
pattern: "^[0-9a-fA-F]{128}$"
83
-
required:
84
-
- client_public_key
85
-
- application_public_key
86
-
- application_signature
94
+
description: "Signature of the application for the Morse AAT."
87
95
88
96
# Shannon Configuration (required for Shannon gateways)
89
97
shannon_config:
98
+
description: "Configuration for the Shannon gateway; if specified, the PATH instance will use the Shannon version of the Pocket protocol."
90
99
type: object
91
100
additionalProperties: false
92
101
required:
93
102
- full_node_config
94
103
- gateway_config
95
104
properties:
96
105
full_node_config:
106
+
description: "Configuration for the Shannon full node. This configuration is used to connect to the Shannon full node to get data from the Pocket blockchain."
97
107
type: object
98
108
additionalProperties: false
99
109
required:
100
110
- rpc_url
101
111
- grpc_config
102
112
properties:
103
113
rpc_url:
114
+
description: "HTTP URL for the Shannon full node."
104
115
type: string
105
116
pattern: "^(http|https)://.*$"
106
117
grpc_config:
118
+
description: "gRPC configuration for the Shannon full node."
107
119
type: object
108
120
additionalProperties: false
109
121
required:
110
122
- host_port
111
123
properties:
112
124
host_port:
125
+
description: "Host and port for gRPC connections, eg. 127.0.0.1:4040"
113
126
type: string
114
127
pattern: "^[^:]+:[0-9]+$"
115
128
insecure:
129
+
description: "Indicates if the gRPC connection is insecure. Must be specified if the full node is notusing TLS."
116
130
type: boolean
117
131
default: false
118
132
base_delay:
133
+
description: "Base delay for gRPC retries."
119
134
type: string
120
135
max_delay:
136
+
description: "Maximum delay for gRPC retries."
121
137
type: string
122
138
min_connect_timeout:
139
+
description: "Minimum connection timeout for gRPC."
123
140
type: string
124
141
keep_alive_time:
142
+
description: "Keep-alive time for gRPC connections."
125
143
type: string
126
144
keep_alive_timeout:
145
+
description: "Keep-alive timeout for gRPC connections."
127
146
type: string
128
147
lazy_mode:
148
+
description: "Indicates if lazy mode is enabled for full node connections."
129
149
type: boolean
130
150
default: false
131
151
gateway_config:
152
+
description: "Configuration for the Shannon gateway, including all required addresses and private keys for all Shannon actors."
Copy file name to clipboardExpand all lines: e2e/morse.example.yaml
+6-6Lines changed: 6 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -7,18 +7,18 @@
7
7
morse_config:
8
8
full_node_config:
9
9
url: "https://pocket-network-full-node-url.io"
10
-
relay_signing_key: "example_relay_signing_key"# ATTENTION: this is a place-holder for a sensitive data item which should never be shared outside your organization.
10
+
relay_signing_key: "40af4e7e1b311c76a573610fe115cd2adf1eeade709cd77ca31ad4472509d38840af4e7e1b311c76a573610fe115cd2adf1eeade709cd77ca31ad4472509d388"# ATTENTION: this is a place-holder for a sensitive data item which should never be shared outside your organization.
0 commit comments