denpa/php-levin

Pure PHP implementation of monero's Levin protocol.

v1.0.1 2019-02-23 22:46 UTC

Requires

• php: >=7.1
• ext-sockets: *

Requires (Dev)

• php-vfs/php-vfs: ^1.4
• phpunit/phpunit: ^7.0 | ^8.0

MIT

• Denis Paavilainen

• network
• p2p
• Monero
• levin

README

Example

require 'vendor/autoload.php';

use Denpa\Levin;

$vars = [
    'network_id' => 'somenetwork',
];

Levin\connection($ip, $port, $vars)->connect(
    function ($bucket, $connection) {
        if ($bucket->isRequest('supportflags', 'timedsync', 'ping')) {
            // respond to supportflags, timedsync and ping requests
            // to keep the connection open
            $connection->write($bucket->response());
        }

        if ($bucket->isResponse('handshake')) {
            // send ping request to the server after
            // receiving handshake response
            $connection->write(Levin\request('ping'));
        }

        if ($bucket->isResponse('ping')) {
            // dump server response to the console
            var_dump($bucket->getPayload());

            // returning false closes connection
            return false;
        }
    }
);

Request Support

command	link	request	response
Handshake	p2p_protocol_defs.h#L177	✅	✅
TimedSync	p2p_protocol_defs.h#L239	✅	✅
Ping	p2p_protocol_defs.h#L297	✅	✅
StatInfo	p2p_protocol_defs.h#L348	❌	❌
NetworkState	p2p_protocol_defs.h#L382	❌	❌
PeerId	p2p_protocol_defs.h#L414	✅	✅
SupportFlags	p2p_protocol_defs.h#L437	✅	✅

Notification Support

command	link	request
NewBlock	cryptonote_protocol_defs.h#L126	✅
RequestGetObjects	cryptonote_protocol_defs.h#L163	❌
ResponseGetObjects	cryptonote_protocol_defs.h#L179	❌
RequestChain	cryptonote_protocol_defs.h#L217	✅
ResponseChainEntry	cryptonote_protocol_defs.h#L231	✅
NewFluffyBlock	cryptonote_protocol_defs.h#L254	✅
RequestFluffyMissingTx	cryptonote_protocol_defs.h#L273	❌

Exceptions

• Denpa\Levin\Exceptions\ConnectionException - thrown on connection errors.
• Denpa\Levin\Exceptions\EntryTooLargeException - thrown when type or packet size is too large.
• Denpa\Levin\Exceptions\SignatureMismatchException - thrown on section or bucket signature mismatches.
• Denpa\Levin\Exceptions\UnexpectedTypeException - thrown on unexpected or invalid type.
• Denpa\Levin\Exceptions\UnknownCommandException - thrown on unknown command.
• Denpa\Levin\Exceptions\UnpackException - thrown when unable to unpack binary data.

License

This product is distributed under the MIT license.

Credits

Loosely based on py-levin.

Donations

If you like this project, you can donate using one of the following addresses:

BTC:
3L6dqSBNgdpZan78KJtzoXEk9DN3sgEQJu
Monero:
458j3EKczYFEE1Gku9ENUgTj4KUtHbqP9hT82vFRdZHiBRfbVFDUE7QArtAB63cNZiKMgBgwrD4k1Wtac8ZgoKx2GUHFpo2
Safex:
Safex61BqfGVucrCo71xPxhQi4L1oMaRYUHwBKMuHVy8UTR1HkBjhJx4WafkLvhSwUeshkonyDjvYFiBrRDeEcrL5k6JLALD85L2T

❤Thanks for your support!❤