RelayAdmin.pm

filter: Statementstmt 86.6% 13 / 15 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub 100% 5 / 5 Podpod n/a totaltotal 90.0% 18 / 20 CC 1 SCAR 0.6
CC
1
Cov
87%
BEGIN
1.3
BEGIN
1.0
BEGIN
1.0
CRAP 1.1
« List.pm ↑ Summary RelayList.pm »
1 package Net::Nostr::RelayAdmin;
2  
3 2 ▶use strictures 2;
Subroutine BEGIN: called CC=1 SCAR=0.0
4  
5 2 ▶use Net::Nostr::_ConstructorArgs ();
Subroutine BEGIN: called CC=1 SCAR=0.0
6  
7 2 ▶use Carp qw(croak);
Subroutine BEGIN: called CC=1 SCAR=0.0
8 2 ▶use JSON ();
Subroutine BEGIN: called CC=1 SCAR=0.0
9 0 ▶use Net::Nostr::HttpAuth qw(create_auth_header);
Subroutine BEGIN: called CC=1 SCAR=2.6
10 use Exporter 'import';
11  
12 our @EXPORT_OK = qw(
13 encode_request
14 decode_response
15 request_with_auth
16 );
17  
18 my $HEX64 = qr/\A[0-9a-f]{64}\z/;
19  
20 my %PUBKEY_METHODS = map { $_ => 1 } qw(
21 banpubkey unbanpubkey allowpubkey unallowpubkey
22 );
23  
24 my %EVENT_ID_METHODS = map { $_ => 1 } qw(
25 allowevent banevent
26 );
27  
28 my %KIND_METHODS = map { $_ => 1 } qw(
29 allowkind disallowkind
30 );
31  
32 my %STRING_METHODS = map { $_ => 1 } qw(
33 changerelayname changerelaydescription changerelayicon
34 );
35  
36 my %IP_METHODS = map { $_ => 1 } qw(
37 blockip unblockip
38 );
39  
40 my %ROLE_DEFINITION_METHODS = map { $_ => 1 } qw(
41 createrole editrole
42 );
43  
44 my %ROLE_ID_METHODS = map { $_ => 1 } qw(
45 deleterole
46 );
47  
48 my %ROLE_ASSIGNMENT_METHODS = map { $_ => 1 } qw(
49 assignrole unassignrole
50 );
51  
52 sub encode_request {
53 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
54 my $method = $args{method};
55 croak "method is required" unless defined $method && length $method;
56  
57 my $params = $args{params} // [];
58 croak "params must be an array reference" unless ref $params eq 'ARRAY';
59  
60 _validate_params($method, $params);
61  
62 return JSON->new->utf8->encode({
63 method => $method,
64 params => $params,
65 });
66 }
67  
68 sub decode_response {
69 my ($json) = @_;
70 croak "response is required" unless defined $json && length $json;
71  
72 my $data = eval { JSON->new->utf8->decode($json) };
73 croak "invalid JSON in response: $@" if $@;
74  
75 if (defined $data->{error} && length $data->{error}) {
76 croak $data->{error};
77 }
78  
79 return $data->{result};
80 }
81  
82 sub request_with_auth {
83 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
84 my $key = $args{key} // croak "key is required";
85 my $relay_url = $args{relay_url} // croak "relay_url is required";
86  
87 my $body = encode_request(
88 method => $args{method},
89 (exists $args{params} ? (params => $args{params}) : ()),
90 );
91  
92 my $auth = create_auth_header(
93 key => $key,
94 url => $relay_url,
95 method => 'POST',
96 payload => $body,
97 );
98  
99 return (
100 body => $body,
101 authorization => $auth,
102 content_type => 'application/nostr+json+rpc',
103 );
104 }
105  
106 sub _validate_params {
107 my ($method, $params) = @_;
108  
109 if ($PUBKEY_METHODS{$method}) {
110 croak "$method requires a 64-char hex pubkey as first param"
111 unless @$params >= 1;
112 croak "pubkey must be 64-char lowercase hex"
113 unless $params->[0] =~ $HEX64;
114 }
115 elsif ($EVENT_ID_METHODS{$method}) {
116 croak "$method requires a 64-char hex event id as first param"
117 unless @$params >= 1;
118 croak "event id must be 64-char lowercase hex"
119 unless $params->[0] =~ $HEX64;
120 }
121 elsif ($KIND_METHODS{$method}) {
122 croak "$method requires a kind number as first param"
123 unless @$params >= 1;
124 croak "kind must be a non-negative integer"
125 unless defined $params->[0]
126 && $params->[0] =~ /\A[0-9]+\z/
127 && $params->[0] == int($params->[0]);
128 }
129 elsif ($STRING_METHODS{$method}) {
130 croak "$method requires a string param"
131 unless @$params >= 1 && defined $params->[0];
132 }
133 elsif ($IP_METHODS{$method}) {
134 croak "$method requires an IP address as first param"
135 unless @$params >= 1 && defined $params->[0] && length $params->[0];
136 }
137 elsif ($ROLE_DEFINITION_METHODS{$method}) {
138 croak "$method requires role id as first param"
139 unless @$params >= 1 && defined $params->[0] && length $params->[0];
140 croak "$method requires label as second param"
141 unless @$params >= 2 && defined $params->[1];
142 croak "$method requires description as third param"
143 unless @$params >= 3 && defined $params->[2];
144 croak "$method requires color as fourth param"
145 unless @$params >= 4 && defined $params->[3];
146 croak "color must be an integer from 0 to 360"
147 unless $params->[3] =~ /\A[0-9]+\z/ && $params->[3] >= 0 && $params->[3] <= 360;
148 croak "$method requires order as fifth param"
149 unless @$params >= 5 && defined $params->[4];
150 croak "order must be an integer"
151 unless $params->[4] =~ /\A[0-9]+\z/;
152 }
153 elsif ($ROLE_ID_METHODS{$method}) {
154 croak "$method requires role id as first param"
155 unless @$params >= 1 && defined $params->[0] && length $params->[0];
156 }
157 elsif ($ROLE_ASSIGNMENT_METHODS{$method}) {
158 croak "$method requires a 64-char hex pubkey as first param"
159 unless @$params >= 1;
160 croak "pubkey must be 64-char lowercase hex"
161 unless $params->[0] =~ $HEX64;
162 croak "$method requires role id as second param"
163 unless @$params >= 2 && defined $params->[1] && length $params->[1];
164 }
165 }
166  
167 1;
168  
169 __END__
« List.pm ↑ Summary RelayList.pm »