Nosial/socialbox-php
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Added client method createSignature

Browse source
This commit is contained in:
netkas 2025-02-11 14:50:57 -05:00
parent 25d1a001fd
commit d82e7042a6
1 changed files with 30 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

30
src/Socialbox/SocialClient.php
View file

@ -16,6 +16,7 @@
use Socialbox\Exceptions\ResolutionException;
use Socialbox\Exceptions\RpcException;
use Socialbox\Objects\Client\ExportedSession;
use Socialbox\Objects\Client\SignatureKeyPair;
use Socialbox\Objects\PeerAddress;
use Socialbox\Objects\RpcRequest;
use Socialbox\Objects\Standard\Contact;
@ -44,6 +45,35 @@
parent::__construct($identifiedAs, $server, $exportedSession);
}
/**
* Create a new signing keypair, sends it to the server and saves it locally with the session so that the client
* can use the SigningKey pair for signing and verifying signatures in the future.
*
* This is not a server-side operation, the server only stores the public key and associates it with the peer's
* profile. The private key is stored locally and is never sent to the server.
*
* @param string|null $name Optional. The name of the signature
* @param int|null $expires Optional. The Unix timestamp of the expiration time
* @return string The UUID of the signature
* @throws CryptographyException Thrown if there was an error while generating the signing key pair
* @throws RpcException Thrown if there was an error with the RPC request
*/
public function createSignature(?string $name=null, ?int $expires=null): string
{
$signature = Cryptography::generateSigningKeyPair();
$uuid = $this->settingsAddSignature($signature->getPublicKey(), $name, $expires);
$this->addSigningKey(new SignatureKeyPair([
'uuid' => $uuid,
'name' => $name,
'public_key' => $signature->getPublicKey(),
'private_key' => $signature->getPrivateKey(),
'expires' => $expires
]));
return $uuid;
}
/**
* Adds a new peer to the AddressBook, returns True upon success or False if the contact already exists in
* the address book.