Nutzap.pm

filter: Statementstmt 83.3% 10 / 12 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub 100% 4 / 4 Podpod n/a totaltotal 87.5% 14 / 16 CC 1 SCAR 0.7
CC
1
Cov
83%
BEGIN
1.3
BEGIN
1.0
BEGIN
1.0
CRAP 1.1
« MintDiscovery.pm ↑ Summary Reaction.pm »
1 package Net::Nostr::Nutzap;
2  
3 1 ▶use strictures 2;
Subroutine BEGIN: called CC=1 SCAR=0.0
4  
5 1 ▶use Net::Nostr::_ConstructorArgs ();
Subroutine BEGIN: called CC=1 SCAR=0.0
6  
7 1 ▶use Carp qw(croak);
Subroutine BEGIN: called CC=1 SCAR=0.0
8 0 ▶use Net::Nostr::Event;
Subroutine BEGIN: called CC=1 SCAR=2.6
9  
10 my $HEX64 = qr/\A[0-9a-f]{64}\z/;
11  
12 use Class::Tiny qw(
13 relays
14 mints
15 p2pk_pubkey
16 proofs
17 mint_url
18 unit
19 recipient
20 event_id
21 event_kind
22 nutzap_ids
23 sender_pubkey
24 );
25  
26 sub new {
27 my $class = shift;
28 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
29 $args{relays} //= [];
30 $args{mints} //= [];
31 $args{proofs} //= [];
32 $args{nutzap_ids} //= [];
33 my $self = bless { %args }, $class;
34 my %known; @known{Class::Tiny->get_all_attributes_for($class)} = ();
35 my @unknown = grep { !exists $known{$_} } keys %$self;
36 croak "unknown argument(s): " . join(', ', sort @unknown) if @unknown;
37 return $self;
38 }
39  
40 sub info_event {
41 my $class = shift;
42 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
43  
44 my $pubkey = $args{pubkey} // croak "info_event requires 'pubkey'";
45 my $relays = $args{relays} // croak "info_event requires 'relays'";
46 my $mints = $args{mints} // croak "info_event requires 'mints'";
47 my $p2pk_pubkey = $args{p2pk_pubkey} // croak "info_event requires 'p2pk_pubkey'";
48  
49 my @tags;
50 for my $relay (@$relays) {
51 push @tags, ['relay', $relay];
52 }
53 for my $mint (@$mints) {
54 push @tags, ['mint', $mint->{url}, @{$mint->{units} // []}];
55 }
56 push @tags, ['pubkey', $p2pk_pubkey];
57  
58 delete @args{qw(relays mints p2pk_pubkey)};
59 return Net::Nostr::Event->new(%args, kind => 10019, content => '', tags => \@tags);
60 }
61  
62 sub nutzap {
63 my $class = shift;
64 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
65  
66 my $pubkey = $args{pubkey} // croak "nutzap requires 'pubkey'";
67 my $recipient = $args{recipient} // croak "nutzap requires 'recipient'";
68 my $proofs = $args{proofs} // croak "nutzap requires 'proofs'";
69 my $mint_url = $args{mint_url} // croak "nutzap requires 'mint_url'";
70 my $unit = $args{unit} // 'sat';
71 my $content = $args{content} // '';
72  
73 croak "recipient must be 64-char lowercase hex" unless $recipient =~ $HEX64;
74  
75 my @tags;
76 for my $proof (@$proofs) {
77 push @tags, ['proof', $proof];
78 }
79 push @tags, ['unit', $unit];
80 push @tags, ['u', $mint_url];
81  
82 if (defined $args{event_id}) {
83 croak "event_id must be 64-char lowercase hex" unless $args{event_id} =~ $HEX64;
84 my @e = ('e', $args{event_id});
85 push @e, $args{relay_hint} if defined $args{relay_hint};
86 push @tags, \@e;
87 }
88 if (defined $args{event_kind}) {
89 push @tags, ['k', '' . $args{event_kind}];
90 }
91  
92 push @tags, ['p', $recipient];
93  
94 delete @args{qw(recipient proofs mint_url unit content event_id event_kind relay_hint)};
95 return Net::Nostr::Event->new(%args, kind => 9321, content => $content, tags => \@tags);
96 }
97  
98 sub redemption {
99 my $class = shift;
100 my %args = Net::Nostr::_ConstructorArgs::normalize(@_);
101  
102 my $pubkey = $args{pubkey} // croak "redemption requires 'pubkey'";
103 my $nutzap_ids = $args{nutzap_ids} // croak "redemption requires 'nutzap_ids'";
104 my $sender_pubkey = $args{sender_pubkey} // croak "redemption requires 'sender_pubkey'";
105 my $relay_hint = $args{relay_hint} // '';
106 my $content = $args{content} // '';
107  
108 for my $id (@$nutzap_ids) {
109 croak "nutzap_id must be 64-char lowercase hex" unless $id =~ $HEX64;
110 }
111 croak "sender_pubkey must be 64-char lowercase hex" unless $sender_pubkey =~ $HEX64;
112  
113 my @tags;
114 for my $id (@$nutzap_ids) {
115 push @tags, ['e', $id, $relay_hint, 'redeemed'];
116 }
117 push @tags, ['p', $sender_pubkey];
118  
119 delete @args{qw(nutzap_ids sender_pubkey relay_hint content)};
120 return Net::Nostr::Event->new(%args, kind => 7376, content => $content, tags => \@tags);
121 }
122  
123 sub from_event {
124 my ($class, $event) = @_;
125 my $kind = $event->kind;
126  
127 if ($kind == 10019) {
128 return $class->_parse_info($event);
129 } elsif ($kind == 9321) {
130 return $class->_parse_nutzap($event);
131 } elsif ($kind == 7376) {
132 return $class->_parse_redemption($event);
133 }
134 return undef;
135 }
136  
137 sub _parse_info {
138 my ($class, $event) = @_;
139 my (@relays, @mints, $p2pk_pubkey);
140  
141 for my $tag (@{$event->tags}) {
142 my $name = $tag->[0];
143 if ($name eq 'relay') {
144 push @relays, $tag->[1];
145 } elsif ($name eq 'mint') {
146 push @mints, { url => $tag->[1], units => [@{$tag}[2 .. $#$tag]] };
147 } elsif ($name eq 'pubkey') {
148 $p2pk_pubkey = $tag->[1];
149 }
150 }
151  
152 return $class->new(
153 relays => \@relays,
154 mints => \@mints,
155 p2pk_pubkey => $p2pk_pubkey,
156 );
157 }
158  
159 sub _parse_nutzap {
160 my ($class, $event) = @_;
161 my (@proofs, $mint_url, $unit, $recipient, $event_id, $event_kind);
162  
163 for my $tag (@{$event->tags}) {
164 my $name = $tag->[0];
165 if ($name eq 'proof') {
166 push @proofs, $tag->[1];
167 } elsif ($name eq 'u') {
168 $mint_url = $tag->[1];
169 } elsif ($name eq 'unit') {
170 $unit = $tag->[1];
171 } elsif ($name eq 'p') {
172 $recipient //= $tag->[1];
173 } elsif ($name eq 'e') {
174 $event_id //= $tag->[1];
175 } elsif ($name eq 'k') {
176 $event_kind //= $tag->[1];
177 }
178 }
179  
180 return $class->new(
181 proofs => \@proofs,
182 mint_url => $mint_url,
183 unit => $unit,
184 recipient => $recipient,
185 event_id => $event_id,
186 event_kind => $event_kind,
187 );
188 }
189  
190 sub _parse_redemption {
191 my ($class, $event) = @_;
192 my (@nutzap_ids, $sender_pubkey);
193  
194 for my $tag (@{$event->tags}) {
195 my $name = $tag->[0];
196 if ($name eq 'e') {
197 push @nutzap_ids, $tag->[1];
198 } elsif ($name eq 'p') {
199 $sender_pubkey //= $tag->[1];
200 }
201 }
202  
203 return $class->new(
204 nutzap_ids => \@nutzap_ids,
205 sender_pubkey => $sender_pubkey,
206 );
207 }
208  
209 sub validate {
210 my ($class, $event) = @_;
211 my $kind = $event->kind;
212  
213 if ($kind == 10019) {
214 my ($has_relay, $has_mint, $has_pubkey);
215 for my $tag (@{$event->tags}) {
216 $has_relay = 1 if $tag->[0] eq 'relay';
217 $has_mint = 1 if $tag->[0] eq 'mint';
218 $has_pubkey = 1 if $tag->[0] eq 'pubkey';
219 }
220 croak "kind 10019 MUST have at least one relay tag" unless $has_relay;
221 croak "kind 10019 MUST have at least one mint tag" unless $has_mint;
222 croak "kind 10019 MUST have a pubkey tag" unless $has_pubkey;
223 } elsif ($kind == 9321) {
224 my ($has_proof, $has_u, $has_p);
225 for my $tag (@{$event->tags}) {
226 $has_proof = 1 if $tag->[0] eq 'proof';
227 $has_u = 1 if $tag->[0] eq 'u';
228 $has_p = 1 if $tag->[0] eq 'p';
229 }
230 croak "kind 9321 MUST have at least one proof tag" unless $has_proof;
231 croak "kind 9321 MUST have a u tag (mint URL)" unless $has_u;
232 croak "kind 9321 MUST have a p tag (recipient)" unless $has_p;
233 } elsif ($kind == 7376) {
234 my $has_e;
235 for my $tag (@{$event->tags}) {
236 $has_e = 1 if $tag->[0] eq 'e';
237 }
238 croak "kind 7376 MUST have at least one e tag" unless $has_e;
239 } else {
240 croak "nutzap event MUST be kind 10019, 9321, or 7376";
241 }
242  
243 return 1;
244 }
245  
246 1;
247  
248 __END__
« MintDiscovery.pm ↑ Summary Reaction.pm »