artur 0.2.0

Universal config-driven Rust HTTP gateway and package orchestrator
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

# This file demonstrates how an application can build a challenge-protected
# space API on top of generic Artur task endpoints.
#
# Artur does not hardcode ALTCHA, wallets, blockchains, or databases here.
# These endpoints call external commands/scripts that you own.
version = 1

[artur.server]
bind = "127.0.0.1"
port = 46796
body_limit_bytes = 1048576

# POST /v1/challenge -> runs the external `challenge` CLI.
# If your crate exposes a different binary name or flags, only this TOML changes.
[[artur.endpoints]]
name = "create_challenge"
method = "POST"
path = "/v1/challenge"
action = "task.run"
task = "challenge_create"

[[artur.tasks]]
name = "challenge_create"
mode = "sync"
command = "challenge"
args = [
  "create",
  "--cost", "5000",
  "--random-counter",
  "--expires-in", "600",
  "--hmac-secret", "{{env.ARTUR_CHALLENGE_HMAC_SECRET}}",
  "--hmac-key-secret", "{{env.ARTUR_CHALLENGE_HMAC_KEY_SECRET}}",
]
timeout_ms = 10000
stdout_format = "json"

[artur.tasks.stdin]
type = "none"

# POST /v1/space -> delegates verification and creation to your application script.
# The script can run:
#   challenge verify --challenge ... --solution ... --secret ... --key-secret ...
# and then create a sid, allocate addresses, persist balances/deposits/expenses, etc.
[[artur.endpoints]]
name = "create_space"
method = "POST"
path = "/v1/space"
action = "task.run"
task = "space_create"

[[artur.tasks]]
name = "space_create"
mode = "sync"
command = "python3"
args = ["examples/scripts/space_create.py"]
timeout_ms = 30000
stdout_format = "json"

[artur.tasks.env]
ARTUR_CHALLENGE_HMAC_SECRET = "{{env.ARTUR_CHALLENGE_HMAC_SECRET}}"
ARTUR_CHALLENGE_HMAC_KEY_SECRET = "{{env.ARTUR_CHALLENGE_HMAC_KEY_SECRET}}"
ARTUR_SPACE_DB = "{{env.ARTUR_SPACE_DB}}"

[artur.tasks.stdin]
type = "body"

# GET /v1/space/{sid} -> delegates lookup to the same application layer.
[[artur.endpoints]]
name = "get_space_by_path"
method = "GET"
path = "/v1/space/{sid}"
action = "task.run"
task = "space_get"

[[artur.tasks]]
name = "space_get"
mode = "sync"
command = "python3"
args = ["examples/scripts/space_get.py", "--sid", "{{param.sid}}"]
timeout_ms = 10000
stdout_format = "json"

[artur.tasks.env]
ARTUR_SPACE_DB = "{{env.ARTUR_SPACE_DB}}"

[artur.tasks.stdin]
type = "none"

# Optional header form: GET /v1/space/ with header `sid: ...`.
[[artur.endpoints]]
name = "get_space_by_header"
method = "GET"
path = "/v1/space/"
action = "task.run"
task = "space_get_by_header"

[[artur.tasks]]
name = "space_get_by_header"
mode = "sync"
command = "python3"
args = ["examples/scripts/space_get.py", "--sid", "{{header.sid}}"]
timeout_ms = 10000
stdout_format = "json"

[artur.tasks.env]
ARTUR_SPACE_DB = "{{env.ARTUR_SPACE_DB}}"

[artur.tasks.stdin]
type = "none"